Skip to content

Using Online Forms

Online forms selection is an end user function from within a selected change package. This function allows you to select available forms for:

  • Entry and modification of the form data.

  • Approval and subsequent approval or rejection.

  • Access to form comments and a form print utility.

    You can also use an extension of the ChangeMan ZMF Package Freeze/Unfreeze function to selectively Freeze or Unfreeze individual forms within a change package.

Accessing Online Forms Selection

The Online Forms Selection panel displays a table of all available forms within the change package and provides line commands for Edit, Browse, Submit, Deactivate, Approve, Reject, Comment, and Print functions.

To access the Online Forms Selection panel:

  1. Select Option 1 (Build) from the Primary Option menu. Press Enter.

  2. Select Option 3 (Custom) from the Build Options menu. Press Enter.

  3. Complete the package ID on the Create/Update Online Forms panel. Press Enter.

    • or -

  4. Select Option 5 (List) from the Primary Option menu. Press Enter.

  5. Complete the parameters on the Package List Parameters panel. Press Enter.

  6. Type OF next to a package ID on the Change Package List panel. Press Enter.

    • or -

  7. Select Option Q (Query) from the Primary Option Menu. Press Enter.

  8. Select Option P (Package) from the Query Options Menu. Press Enter.

  9. Complete the parameters on the Query Package Parameters panel. Press Enter.

  10. Type S next to a package ID on the Query Package List panel. Press Enter.

  11. Type S next to Custom Forms on the Package Information Categories panel. Press Enter.

    • or -

  12. Select Option O (OFMlist) from the Primary Option Menu. Press Enter.

  13. Complete the parameters on the Online Forms Package Parameters panel. Press Enter.

  14. Type S next to a package ID on the Online Forms Package List panel and press Enter. The Update Online Form Selection panel (CMNZMGR) appears. 

    CMNZMGR -------------- UPDATE: ONLINE FORMS SELECTION --------------- ROW 1 TO 10 OF 10
COMMAND ===>                                                            SCROLL ===> CSR

        PACKAGE ID: TEST000001      STATUS: DEV     INSTALL DATE: 940601

Line commands: E - Edit,        B - Browse,     S - Submit,     D - Deactivate,
               A - Approve,     R - Reject,     C - Comment,    P - Print

Press ENTER to process; Enter END command to exit.

    FORM                                            LEAD    DAYS            LAST
      ID FORM DESCRIPTION                           TIME    LEFT STATUS     USERID
'''' 010 Build GDG Request                          0       44   ACTIVE     CMNUSER1
'''' 030 DASD Dataset Space Request                 7       37
'''' 070 Problem Summary                            7       37
'''' 100 Report Distribution Information            7       37
'''' 110 Standards & Guidelines Revision            7       37
'''' 120 Tape Retention Register                    7       37   REJECTED    CMNUSER2
'''' 130 Standards Exemption Request                7       37
'''' 140 Security Information                       7       37
'''' 160 Scheduler JCL Update                       7       37
'''' 170 Scheduler Update                           7       37
******************************** BOTTOM OF DATA ***************************************

    Use the following line commands to access forms or change the form status as required.

    Note

    The available line commands depend on the package status, form status, remaining days, and user access rights. |

    Field Explanation
    Line Commands-- E - Edit Displays the form in edit mode and sets the form status to ACTIVE when exiting with the End command.
    B - Browse Displays the form in browse mode.
    S - Submit Sets the form status to SUBMITTED and notifies all defined form approvers, specified with Global OFM panel (CMNZNTF) of a pending forms approval.
    D - Deactivate Clears the form status but retains any form data and form comments.
    A - Approve Sets the form status to APPROVED and optionally submits the approve job skeleton, as well as notifying the user specified in the Notify user field of the forms approval through MVSSEND.
    R - Reject Sets the form status to REJECTED and displays the Form Comments panel, as well as notifying the user specified in the Notify user field of the forms rejection through MVSSEND.

Editing Forms

To access an Online Form in edit mode, do the following from the Online Forms Selection panel:

  1. Type E (Edit) in the line command field of the selected form. (Sample form 010 - Build

    GDG Request was selected for this example.)

  2. Press Enter. The Edit Build GDG Request panel (CMNZ0101) appears and locks the form to prevent update by another user. If the form is in use by another user a message displays and the command is aborted. 

    CMNZ0101 ------------- EDIT: BUILD GDG REQUEST -------------ROW 1 TO 13 OF 13
COMMAND ===>                                                 SCROLL ===> PAGE

        PACKAGE ID: TEST000001      STATUS: DEV         INSTALL DATE: 19971230

Press ENTER to process; Enter END command to exit.

     INDEX                                   ENTRIES     DELETE      EMPTY
‘’’’ TEST.DATASET.NAME01____________________ 10_         YES         NO_
‘’’’ TEST.DATASET.NAME02____________________ 10_         YES         NO_
‘’’’ TEST.DATASET.NAME03____________________ 10_         YES         NO_
‘’’’ TEST.DATASET.NAME04____________________ 10_         YES         NO_
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___
‘’’’ \______________________________________ ___         ___         ___ 
***************************** BOTTOM OF DATA *********************************

  3. Use an Online Form in edit mode.

    An Online Form consists of single or multiple panels containing table and non-table variables. Forms using multiple panels allow navigation using Enter to display the next panel (if all validation for the panel is passed) and the End command to return to the previous panel. If a form contains table variables, then the first panel contains scrollable rows with a line command input area for each row. This line command area allows I, R, and D commands and, if the form contains multiple panels, the S command to display the next panel. Exiting from the form with the End command always saves the form data in the package master file. The form status is set to ACTIVE and the last user ID field is updated. If no data exists (all form variables contain null values) then the form status and last user ID fields are cleared. To avoid updating the last user ID field when no changes have been made to the form data, use the Cancel command.

Form Locking

This function incorporates a locking facility that locks the form on entry and unlocks the form on exit preventing update by more than one user at a time. Attempts to use an update function on a form currently locked by another user results in an error message and the command is aborted. A form can remain locked when the user is unable to exit normally due to a system failure or session time-out. The OFM allows access to the form if the current user ID is the same as that under which the form was previously locked or if the current user ID has local or global administrator rights.

Browsing Forms

To access an Online Form in browse mode, do the following from the Online Forms Selection panel:

  1. Type B (Browse) in the line command field of the selected form.

  2. Press Enter. The Browse Build GDG Request panel (CMNZ0101) appears. 

    CMNZ0101 -------------- BROWSE: BUILD GDG REQUEST ------------------ ROW 1 TO 4 OF 4
COMMAND ===>                                                        SCROLL ===> PAGE

            PACKAGE ID: TEST000001      STATUS: DEV         INSTALL DATE: 19971230

Press ENTER to process; Enter END command to exit.

        INDEX                           ENTRIES         DELETE      EMPTY
‘’’’    TEST.DATASET.NAME01____________ 10_             YES         NO_
‘’’’    TEST.DATASET.NAME02____________ 10_             YES         NO_
‘’’’    TEST.DATASET.NAME03____________ 10_             YES         NO_
‘’’’    TEST.DATASET.NAME04____________ 10_             YES         NO_ 
******************************** BOTTOM OF DATA *************************************

  3. Use the Online Form in browse mode.

    An Online Form consists of single or multiple panels containing table and non-table variables. Forms that use multiple panels allow navigation using Enter to display the next panel (if all validation for the panel is passed) and the End command to return to the previous panel. If a form contains table variables, then the first panel contains scrollable rows with a line command input area for each row. This line command area allows the S command to display the next panel if the form contains multiple panels.

Submitting Forms for Approval

To use the Submit function, do the following from the Online Forms Selection panel.

  1. Type S (Submit) in the line command field of the selected form.

  2. Press Enter.

    This changes the form status to SUBMITTED and updates the last user ID field. A message is sent to all user IDs in the notification definition that the form is waiting for their approval. If the form is in use by another user, a message displays and the command is aborted.

Deactivating Forms

To use the Deactivate function, do the following from the Online Forms Selection panel:

  1. Type D (Deactivate) in the line command field of the selected form.

  2. Press Enter.

    This clears the form status and last user ID fields. All form data and form comments are retained. The form may be edited subsequently and the status reset to ACTIVE. If the form is in use by another user, a message displays and the command is aborted.

Approving Forms

To use the Approve function, do the following from the Online Forms Selection panel.

  1. Type A (Approve) in the line command field of the selected form.

  2. Press Enter.

    If the form allows submit at approval, the Job Statement Information panel (CMNJOBCD) is displayed.

    CMNJOBCD                        Job Statement Information
COMMAND ===>

Job Statement Information

 _//USER001    JOB (0000),’CHANGE MAN’,_______________________________
 //              CLASS=A,MSGCLASS=X,NOTIFY=USER001_____________________
 //*___________________________________________________________________
 //*___________________________________________________________________

  3. Enter valid job statement information and press Enter.

    This sets the form status to APPROVED and, if the form allows submit at approval, invokes processing of the approve job skeleton which submits the output job stream for execution.

    Upon successful completion, a jobname(jobnumber) submitted message is received from the ChangeMan ZMF started task. Any errors detected during skeleton processing are indicated by standard ISPF Dialog Manager messages. (Press PF1 for the long message text.)

    Note

    • You must have authorization to a security entity created by your security administrator to approve a form.
    • Your application administrator may prohibit approving packages and forms for packages you created. (Application Administration Parameters: Package creator cannot approve)
    • Your application administrator may prohibit approving packages and forms for packages in which you worked on a component. (Application Administration Parameters: Package worker cannot approve.)

Rejecting Forms

To use the Reject function, do the following from the Online Forms Selection panel.

  1. Type R (Reject) in the line command field of the selected form.

  2. Press Enter.

    This changes the form status to REJECTED and updates the last user ID field. If the form is in use by another user, a message displays and the command is aborted.

Commenting Forms

To access the Form Comments panel, do the following from the Online Forms Selection panel.

  1. Type C (Comments) or R (Reject) in the line command field of the selected form.

  2. Press Enter. The Form Comments panel (CMNZCMT) appears and locks the form to prevent updates by another user. If the form is in use by another user, a message displays and the command is aborted. 

    CMNZCMT --------------------- FORM COMMENTS -------------------------------  
COMMAND ===>

    PACKAGE ID: TEST000001      STATUS: DEV         INSTALL DATE: 19971230    

    FORM ID: 120    DESCRIPTION: Tape Retention Register   

Press ENTER to process; Enter END command to exit.
COMMENTS:   
===> Rejected due to non-standard dataset name - MWS 9/18/1997   
===>   
===>   
===>   
===>   
===>   
===>   
===>   
===> 
===>

Using the Form Comments Panel

Type comments into unused comments lines as required. Non-blank comment lines are protected from input in order to maintain a log of comments. Intervening blank lines are removed when the data is saved. Terminate comments with the id of the author and the date and time.

Form Locking

This function incorporates a locking facility that locks the form on entry and unlocks the form on exit preventing update by more than one user at a time. Attempts to use an update function on a form currently locked by another user results in an error message and the command is aborted. A form can remain locked when the user is unable to exit normally due to a system failure or session time-out. The OFM allows access to the form if the current user ID is the same as that under which the form was previously locked or if the current user ID has local or global administrator rights.

Printing Forms

To print Online Forms, do the following from the Online Forms Selection panel:

  1. Type P (Print) in the line command field of the selected form.

  2. Press Enter.

    The Job Statement Information panel (CMNJOBCD) is displayed.

    CMNJOBCD                          Job Statement Information
COMMAND ===>

Job Statement Information

   //USER001___JOB_(0000)_,_’CHANGE MAN’,______________________________
  // ____________CLASS=A,MSGCLASS=X,NOTIFY=USER001_____________________
  //*__________________________________________________________________
  //*__________________________________________________________________

  3. Enter valid job statement information and press enter.

    This invokes the print job skeleton that submits the output job stream for execution. Upon successful completion, a jobname(jobnumber) submitted message is received from the ChangeMan ZMF started task. Any errors detected during skeleton processing are indicated by standard ISPF Dialog Manager messages. (Press PF1 for the long message text.)

Online Forms Freeze/Unfreeze

The Online Forms Selection panel displays a table of all available forms within the change package and provides access to all the functions necessary for selectively freezing and unfreezing individual forms.

To access the Online Forms Freeze/Unfreeze panel:

  1. Select Option 2 (Freeze) from the Primary Option menu. Press Enter.

  2. Select Option 3 from the Freeze Options menu. Press Enter.

  3. Type S in the line command field next to Custom Forms in the Selective Freeze/ Unfreeze panel. Press Enter.

    This displays the Online Forms Freeze/Unfreeze panel (CMNZUNF).

    CMNZUNF ----------------- ONLINE FORMS FREEZE/UNFREEZE ------------------------------
COMMAND ===>                                                         SCROLL ===> PAGE
            PACKAGE ID: TEST000002  STATUS: DEV         INSTALL DATE: 19971230  

Line commands:  F-Freeze,   U-Unfreeze    

Press ENTER to process; Enter END command to exit.    

    FORM                                        LEAD DAYS                   LAST
     ID     FORM DESCRIPTION                    TIME LEFT STATUS            USERID 
f’’’ 120        Tape Recovery Form              10   6    ACTIVE            USER85

    Use the following line commands to freeze or unfreeze the forms as required. If the form is in use by another user, a message displays and the command is aborted. 

    | Field     | Explanation                                                       |
|---------------|-----------------------------------------------------------------------|
| Line Commands | **F - Freeze** Freezes the form.  |
|               | **U - Unfreeze** Unfreezes the form.|