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