Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

Specifying the TOMID and TOMPLEX parameters

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

Note

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).

Note

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.

Note

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)

Related topic

Coding-conventions

 

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