Automatically Create a Unique zOS Command ID Using OPC Variables

Automatically Create a Unique z/OS Command ID for your Universal Agent Process Using OPC Variables

OPC has a set of reserved variables available that get substituted at job submission.

The feature gets switched on by coding the following JCL statements:

  • //*%OPC SCAN            <== set substitution on and off by
  • //*%OPC NOSCAN      <== set substitution off

Any OPC variable found within the instream JCL can be substituted with the current value by OPC. (See the IBM OPC documentation for instructions on variable usage.)

//S1 EXEC UCMDPRC
//LOGONDD  DD DISP=SHR,DSN=hlq.encrypted.file         
//SCRIPTDD DD * 
DIR
SYSIN    DD *  
-cmdid payrolljob&CYMD.&CHHMMSSX.                                                     <== OPC variables
-script scriptdd -host dallas -encryptedfile logondd -managerft yes -restart no  
/*

Expanded Results:

//S1 EXEC UCMDPRC
//LOGONDD  DD DISP=SHR,DSN=hlq.encrypted.file         
//SCRIPTDD DD *
dir
//SYSIN    DD *
-cmdid payrolljob2003061613315614
-script scriptdd -host dallas -encryptedfile logondd -managerft yes -restart no
/*



* If the cmdid identifier contains spaces, it must be enclosed in either single ( ' ) or double ( " ) quotation marks.

SYSIN Options

The SYSIN options used in this example are:

Option

Description

-cmd

Command to execute on the remote system.

-scriptddname from which to read a script file. The script file is sent to the remote system by UCMD Manager for execution.

-host

Host name or IP address of the remote system on which to execute the script.

-encryptedfileddname from which to read an encrypted command file created with the Universal Agent Universal Encrypt (UENCRYPT) utility.

-managerft

Specification for whether or not the Manager Fault Tolerance (MFT) feature is used. A value of yes specifies that MFT should be used.

-restart

Specification for whether or not the manager is requesting restart. A value of yes indicates the Manager is being restarted.

Components

Universal Command Manager for z/OS