LIST-Return codes


The following table shows the possible values for TOMRC and what they mean.

Return codes for the TOMEXEC LIST function

Return code

Explanation

0

Command was completed successfully.

16

Syntax error occurred.

17

FUNCTION keyword is missing.

100

No active TOMs meet your criteria.

101

Internal error occurred.

102

The TOM, TOMPLEX or SYSPLEX specified is not active.

118

Security violation occurred.

138

TYPE keyword was not specified.

139

Invalid value specified for TYPE

140

Function is invalid

144

TOM CAS is not active.

145

RTCS is not active.

148

Request timed out and can be re-tried.

210

The requested TOMID or TOMPLEX is not TOM version 2.x and is not compatible with this version.

Note

If the function fails, the LINE.EXCEPT.0-n variables will contain the reason for the failure. It is a good practice to code EXECs to check the TOMRC variable after the function and display the LINE.EXCEPT.n variables when the TOMRC variable is a non zero value.

See the following table for a list of variables and example values that the TOMEXEC LIST function returns.

REXX stem variables and sample returned values: function LIST

TYPE() keyword

Line.0

Line.n

OBJECT

Number of defined objects

Name of an object

SET

Number of defined sets

Name of a set

OBJBASE

Number of object definition bases

Name of an object definition base

CALBASE

Number of calendar definition bases

Name of a calendar definition base

DAY

Number of calendar day entries in the calendar definition base

Name of a calendar day entry

TIME

Number of time entries in the calendar definition base

Name of a calendar time entry

PERIOD

Number of period entries in the calendar definition base

Name of a calendar period entry

CALSET

Number of set entries in the calendar definition base

Name of a calendar set entry

LAYERPLEX

Number of layer sysplexes

Name of a layer sysplex

SYSLAYER

Number of system layers

Name of a system layer

PLEXLAYER

Number of sysplex layers

Name of a sysplex layer

REXX stem variables and ample returned values: LIST TYPE(TOMSYSTEM)

REXX stem variable

Explanation

line.0

Number of TOM systems

line.n.name

TOM ID name

line.n.tomplex

Name of the TOMPLEX to which the TOM system belongs

line.n.sysplex

Name of the SYSPLEX where the TOM runs

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*