Specifying the TOMID and TOMPLEX parameters

The optional TOMID and TOMPLEX parameters control which TOM PAS receives the TOMEXEC function.

Related topic

Coding-conventions

Important

Do not specify both parameters.

The default value of the TOMPLEX parameter is an asterisk (*), which specifies any or all TOMPLEXs (as appropriate for the requested function).

Important

You can only issue TOMEXEC functions to a TOM PAS that is on the MVS system that is running the EXEC.

If you omit the TOMID and the TOMPLEX parameters, a search is performed to find an active TOM on the system on which the EXEC is scheduled. This method is recommended.

Important

If multiple qualifying TOMs are found on a single MVS system, it is not predictable which TOM PAS is selected. You must specify the TOMID parameter in the TOMEXEC command to use TOMEXEC API functions.

When the TOMPLEX parameter is specified, for example TOMPLEX(BBEX01), a search is performed to find an active TOM belonging to the TOMPLEX named BBEX01 on the MVS system where the EXEC is scheduled.

Example

TOMEXEC FUNCTION(xxx)

TOMEXEC FUNCTION(xxx) TOMID(yyy)

TOMEXEC FUNCTION(xxx) TOMPLEX(zzz)

 

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