Identification keywords

Use the following keywords to identify the potential operations to update. You can use any combination of the following keywords.

ADID(<adid>)

Searches for operations within applications with name <adid> for the operations to update. You can use the wildcards asterisk (*) and percent sign (%).

CLNSTAT(C|E)

Searches for operations by cleanup result.

CLNTYPE(A|I|M|N)

Searches for operations by cleanup type.

CONDRJOB(Y|N)

Searches for operations depending on whether they are conditional recover jobs.

DPREM(Y|N)

Searches for jobs depending on whether they are marked as removable from the current plan by planning processes.

ERRCODE(xxxx)

Searches for operations with the specified error code.

EXECDEST(xxxxxxxx)

Searches for jobs that executed on the specified destination.

EXPJCL(Y|N)

Searches for operations based on the expanded JCL setting.

EXTNAME(<extended-jobname>)

Searches for operations by extended job name.

EXTSE(xxxxxxxxxxxxxxxx)

Searches for operations by scheduling environment.

GROUP(xxxxxxxx)

Searches for operations by authority group.

IA(<iadatetime>)

Alternative way to set the DATE and TIME keywords in a single keyword. Use the equal sign (=) to set the current date and time; use the plus sign (+) and minus sign (–) to set a relative date, the time portion will be set to asterisk (*). If you specify only a date, the time will be set to asterisk (*).

==

Special short form for a Workload Automation Programming Language job that is being controlled by HCL Workload Automation for Z. If you specify ==, the ADID, DATE, and TIME values are set to the same values as the controlling occurrence, constraining the command to search only for operations in the same occurrence.

JOBCRT(P|W|N)

Searches for operations by critical job type.

JOBNAME(<jobname>)

Searches for jobs named <jobname>. You can use wildcards asterisk (*) and percent sign (%).

JOBPOL( |L|D|S|C)

Searches by late job policy.

MONITOR(Y|N)

Searches for operations by their external monitor setting.

OPNO(<opno>)

Searches for an operation numbered <opno>. You cannot use wildcards.

OWNER(xxxxxxxxxxxxxxxx)

Searches for operations by owner ID.

PRIORITY(n)

Searches for operations by priority.

SHADOWJ(Y|N)

Allows shadow jobs to be identified.

UNEXPRC(Y|N)

Allows conditional jobs with unexpected return codes to be identified.

USRSYS(Y|N)

Allows jobs that store user sysout to be identified.

VIRTDEST(xxxxxxxx)

Searches for jobs submitted on the specified destination.

WAITFORW(Y|N)

Allows wait operations to be identified.

WAITSE(Y|N)

Allows operations waiting for a scheduling environment to be identified.

WLMSCLS(xxxxxxxx)

Searches for operations by WLM service class.

WMPRED(Y|N)

Allows operations waiting for mandatory pending predecessors to be identified.

WPMPRED(Y|N)

Allows operations waiting for either mandatory pending or pending predecessors to be identified.

WPPPRED(Y|N)

Allows operations waiting for pending predecessors to be identified.

WSNAME(<wsname>)

Searches for operations scheduled on the <wsname> workstation. You can use wildcards asterisk (*) and percent sign (%).

STATUS(<status>)

If not specified, the command uses the status default values, as described hereafter. You can use the NE modifier to specify all statuses except one. For example, STATUS-NE(C) finds all statuses except Complete (C). STATUS(*) selects only the status of * (Ready with none-reporting predecessor). To find more than one status, you can list all the statuses in the same keyword; for example STATUS(AR*) lists the statuses Arriving, Ready and Ready with none-reporting predecessor. To list all possible values for status, use the percent sign (%), like in STATUS(%).

DATE(<yymmdd>) (or IADATE)

Searches for operations scheduled with a particular application input arrival date in the format YYMMDD. You cannot use wildcards, but you can use relative dates:

=: The current date
+n: The current date + n days
-n: The current date - n days

TIME(<hhmm>) (or IATIME)

Searches for operations scheduled at a particular application input arrival time in the format HHMM. TIME cannot be used without DATE and shows as an invalid value if TIME is set without DATE. You can use only the wildcard asterisk (*) for the complete time field, but you can also use relative times:

=: The current time
+n: The current time + n minutes
-n: The current time - n minutes
USRF(<name>=<value>): Searches for operations with the specified user field. The equal sign (=) is used to separate the field name from the field value, but you can also use modifiers. For example, USRF-GE(MYFIELD=100) looks for operations where user field MYFIELD is set to a value of 100 or greater.

You can use comparators can be used, for exampleDATE-LE, on all identification keywords except TIME. The DATE and TIME fields are combined to form an Input Arrival time search, therefore the comparator specified against DATE is used as the comparator for the combined Input Arrival.

Depending on the command, the default value for STATUS is:

FORCE: AR*
KILL: S
REPLY: E

For all the other commands, the default value is ARW*.