Starting ZDT/CICS

You can invoke ZDT/CICS:

  • By submitting a batch job, or
  • Directly (if ZDT/CICS has been configured to connect to ZCC server).
To start ZDT/CICS, enter the transaction name for Z Data Tools:
HFM userid (invocation options)
To run ZDT/CICS from another CICS® application, code this command: 
EXEC CICS LINK PROGRAM('HFM3CICS') COMMAREA('HFM userid (invocation options)')
Where:
HFM
  • For the transaction invocation, this is the default transaction name for Z Data Tools.
    Note: The default transaction name, HFM, may have been changed at your site during installation due to local standards or other reasons. If you change this value, then you must also change the HFM3POPT options module to reflect the current transaction identifier for the (BACKGROUND) option to work.
  • For the coded command (when running from another CICS application), this is required and must be the first two characters in the COMMAREA
userid
Is optional. Each ZDT/CICS user is required to provide an MVS userid and (on the next panel) the password. If you omit the userid then:
  • If you have signed on using CESN and the product has been installed with either *DEFAULT=SIGNON or *PASSWORD=REMEMBER, then the userid defaults to the signed-on userid.
  • If you have not signed on, then you are prompted for a userid before the logon panel is presented.
invocation options
These options allow you to specify how you want to invoke ZDT/CICS. You specify them within parentheses, separated with a space:
START=BATCH
Invokes ZDT/CICS by submitting a batch job. You only need to specify this option if the installation option is set to START=TASK and you want to override it.
START=TASK
Invokes ZDT/CICS directly (non-batch). You only need to specify this option if the installation option is set to START=BATCH and you want to override it.
BACKGROUND
Instructs ZDT/CICS to run non-terminal processing in a background task.
Once a valid userid has been specified to the HFM transaction, ZDT/CICS displays the Z Data Tools for CICS Logon panel. There are two forms of this logon panel:
  • The batch invocation panel is displayed when START=BATCH is in effect at logon. It submits a batch job that invokes ZDT/CICS.
  • The non-batch invocation panel is displayed when START=TASK is in effect at logon.
Note: The Z Data Tools for CICS Logon panel is displayed for every user the first time the HFM transaction is entered. The logon panel can be bypassed on subsequent invocations of the HFM transaction if all of the following conditions are true:
  • The *PASSWORD=REMEMBER install option has been specified.
  • You have already signed on to CICS.
  • The userid has been omitted when invoking the HFM transaction.
  1. On the Z Data Tools for CICS Logon panel, enter your password in the Password entry field.

    The Password entry field is normally the only field on the Z Data Tools for CICS Logon panel in which you need to enter details (all the entry fields are prefilled). If this is the case, go to Step 9.

  2. To change the current password for the MVS userid, enter the new password in the New Password field. The new password must comply with the password rules for your system. If the new password is valid, you are prompted to enter the new password again to confirm. If you enter the same password again, your new password is accepted.

    (Non-batch invocation only.) You can enter a passphrase of up to 100 characters.

  3. (Batch invocation only.)

    If necessary, specify the node on which the job is to run in the Node field. A /*ROUTE XEQ node.user statement is added after the job card to run the job on the specified machine.

  4. (Batch invocation only.)

    If necessary, in the Procedure field, specify the procedure name for running Z Data Tools on your system. This must be available from an active procedure library. The installation default procedure is HFM3CICB.

  5. If necessary, in the Profile data set field, specify the name of the profile data set to be used to save session information for subsequent invocations. The userid must have access to create and update the specified data set, or the batch job fails. If the data set does not exist, the batch procedure creates it. If the data set exists, it must be a fixed-blocked partitioned data set (preferably a PDSE, if possible) with LRECL of 80.
  6. If necessary, in the Prefix field, specify the prefix to be used as the high-level qualifier when specifying unquoted data sets during the Z Data Tools session. If you do not want prefixing on unquoted data set names, leave this field blank.
  7. (Batch invocation only.)

    If necessary, in the Jobcard entry field lines, edit the jobcard details for the submitted job.

    The jobcard can use the following variables which are substituted when the job is submitted:
    &TERM
    The current 1–4 character terminal ID is substituted.
    &USER
    The current 1–7 character MVS userid is substituted.
    Note:
    1. You can terminate the variable with a period which will also be removed during substitution.
    2. The jobcard should be unique and assigned to a class where it will run immediately.
  8. (Non-batch invocation only.)

    The Port field shows the port number used to connect to the ZCC server.

    The Host name field shows the name of the system where the ZCC server is running. If it is blank, then ZDT/CICS obtains and uses the host name of the current system.

  9. To submit the batch job that invokes ZDT/CICS, press Enter.

    When the job is submitted, the logon panel waits for 20 seconds for the job to start and respond. If the job has not responded, it issues a "Job not responding" message. You need to check on the status of the job and either press F5 to wait a further 20 seconds, or press Enter to resubmit the job with any applicable changes. Look up the error message number in the Z Data Tools User's Guide and Reference for further information if the job is not responding.

    ZDT/CICS displays the ZDT/CICS Primary Option Menu.

  10. For View (option 1), Edit (option 2), and Print (option 3.2, reached by means of Utilities, option 3), you must specify the CICS Resource. The CICS Resource option setting on the Primary Option Menu is not used by the other functions.
  11. Select the option you want by typing the corresponding highlighted number on the command line.

    For example, to edit a CICS file:

    1. Set the CICS Resource option to 1 (File).
    2. Type 2 (Edit) in the command line.
    3. Press Enter.

Related topics