Process Macros › SHDCALL Macro

SHDCALL Macro

The SHDCALL macro passes a command to the CA 7 batch scheduler and returns the response.

Note: If you want to use this macro, you must first complete and action the SCHEDAPI Customizer parameter group (shortcut /PARMS).

Parameters: SHDCALL Macro

Scheduler Product

Specifies the scheduler product to which the commands are passed.

Scheduler SSID

Specifies the subsystem ID of the scheduler product to which the commands are passed. The default is the value entered in the SCHEDAPI Customizer parameter group.

Command

Specifies one or more commands passed to the scheduler product. Use a semicolon (;) as a command separator.

Time-out

Specifies the maximum time, in seconds, that the region waits for a response from the scheduler product. The time is reset each time a response is received. The macro waits until a message is received, or until the time expires without receiving any response.

Limits: A number from 1 through 999.

Default: 30.

Returned Variables: SHDCALL Macro

&$RM$CNT

The number of response text lines.

&$RM$1 to &$RM$999

Every line in the response.

&$RM$MSG

The error message if the return code is not zero.

&$RM$RC

The return code

To run the macro interface, the STEPLIB statement in the CA 7 started task JCL must be concatenated in the CA NetMaster started tasks JCL. Following is an example:

//STEPLIB DD DSN=dsnpref.pvpref.MS.CC2DLOAD, 
// 	 DD DISP=SHR,DSN=CD.Vnnnn.LINKLIB 
// 	 DD DISP=SHR,DSN=dsnpref.CA7Vnn.CAILIB 
// 	 DD DSN=SYS1.SISTCLIB,DISP=SHR