Arguments
You can specify arguments to:
- Determine if a recovery environment is established. The recovery environment consists of a SPIE exit routine and an ESTAE recovery routine, which, in case of error, dumps certain storage areas and terminates execution. You can specify argument name ESTAEI, ESTAER, LUNAME, or NOESTAE. Argument values are not required.
- Identify the message log to which that messages are written.
- Argument name=ACCOID
- The parameter that determines if the
OI database is to be accessed when a LIST or SELECT request on CP operations is issued.
- Argument value=accoid
- A 1-byte character field for the accoid: valid values are Y or N. Y means that the OI database is read (this is the default). N means that the OI database is not read.
- Argument name=DUBPROC
- The
parameter with which the BPX1SDD routine is invoked for the program
interface TCP/IP session.
- Argument value=dubproc
- A 1-byte character field for the dubproc: valid values are Y or N. Y means that BPX1SDD is invoked by using DUBPROCESS parameter. N means that BPX1SDD is invoked by using DUBPROCESSDEFER parameter. The default is N.
- Argument name=ESTAEI
- The recovery environment is established at the INIT request. It remains in effect until the TERM request. This is the default.
- Argument name=ESTAER
- The recovery environment is established and terminated for each individual request. This might be needed if, for example, your program has a recovery environment dependent on the setting of a certain register, as in PLI.
- Argument name=LUNAME
- This argument allows the user to specify a server or controller
LU name for the program interface session.
- Argument value=luname
- A 17-byte field for the LU name address, ending by a blank if shorter than 17 bytes.
- Argument name=MLOGDDN
- This argument
identifies a message log that messages are written to, rather than
the default message log, EQQMLOG.
Each INIT request requires its own message log. If you make more than one INIT request before a TERM request, or if PIF is invoked by a program or started task that is already using EQQMLOG, specify MLOGDDN for each additional INIT request. If MLOGDDN is not specified, and EQQMLOG is already in use, message EQQZ038E is written to the SYSLOG and the INIT request fails.
- Argument value=ddname
- An 8-character field, left justified, which identifies the ddname of the data set that messages are written to.
- Argument name=NOESTAE
- No recovery environment is established.
- Argument name=PIFDLCHECK
- For occurrences that are dynamically added to the current plan through OCL, PIF, or BCIT
without setting a deadline, PIFDLCHECK enables HCL Workload Automation for Z to
flexibly set a deadline.
- Argument value=Y
- When the occurrence deadline to be taken from the first run cycle is not available or is earlier than the Input Arrival time, HCL Workload Automation for Z sets the deadline as the IA time + 8 hours.
- Argument value=N
- Default. HCL Workload Automation for Z sets the occurrence deadline as the IA time plus 8 hours only if the deadline to be taken from the first run cycle is not available. If it is available and is earlier than the Input Arrival time, an error condition occurs.
- Argument name=REMHOST
- The server host name for the program interface TCP/IP session.
REMHOST and LUNAME are mutually exclusive.
- Argument value=server hostname
- A 52-byte field for the host name address, ending by a blank if shorter than 52 bytes.
- Argument name=REMPORT
- The server port number for the program interface TCP/IP session.
REMHOST and LUNAME are mutually exclusive.
- Argument value=server port number
- A 4-byte integer field for the port number: valid values are from 0 to 65535.
- Argument name=USRLEV
- This argument communicates to EQQYCOM the level of the user program. If not specified,
the programming interface assumes that the user-written program is invoking the PIF program at its
latest version, and you need to recompile to see the changes in the segment layouts. In this
situation, PIF uses new layouts to communicate with old user program.
According to the functions that you are using (earlier or later than HCL Workload Automation for Z V9.5), specify one of the following values:
- Argument value=n
- Identifies the level of the user program. The valid values are:
- 9
- Identifies the enablement of changes done for IBM Workload Scheduler for z/OS V9.3 through the APAR PI57310.
- 10
- Identifies the enablement of changes done for IBM Workload Scheduler for z/OS V9.3 through the APARs PI62520 and PI62521.
- 11
- Identifies HCL Workload Automation for Z V9.5. If you are using this level, you need to recompile the user-written applications to see the changes in the segment layouts.
- 12
- Identifies the enablement of changes done for HCL Workload Automation for Z V9.5.
- 13
- Identifies the enablement of changes done for HCL Workload Automation for Z V9.5 through the Package HWAZ_9502_APAR_HC00001.
- 14
- Identifies the enablement of changes done for HCL Workload Automation for Z V9.5 through the Package HWAZ_9503_APAR_HC00002.