Shutting Down CA 7 Using The Batch Terminal Interface

Document ID : KB000013363
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

I am trying to set up a SASSBSTR job to issue /SHUTDOWN,Z3. Why am I receiving this error message? 

SCM2-10 /SHUTDOWN MAY BE ENTERED FROM CA-7 MASTER TERMINAL ONLY.

Answer:

The /SHUTDOWN command requires that any terminal that issues it be defined as either master or alternate console. Below is an example of defining a batch terminal as an alternate console in the CA 7  Initialization File.   
GROUP,NAME=BTERM01,DEVICE=BATCH,LNAME=BLINE1 
LINE,NAME=BLINE1,BUFSIZE=3120,TNAME=BTERM1 
TERM,NAME=BTERM1,DEVICE=BATCH,NLINE=60,LINLEN=137,CONS=ALTRN <---(CONS=ALTRN or MASTR)

As with most Initialization File changes, CA7 will need to be brought down and started again with TYPE=ERST to implement this change. Then on the SASSBSTR job that performs the shutdown, include the PARM=n on the EXEC statement to ensure it is routed to the batch terminal defined is MASTR or ALTRN (unless all of them are set up in this way). 

Additional Information:

CA Workload Automation CA 7 Edition System Programming Guide (Initialization File Statements) 

CA Workload Automation CA 7 Edition Command Reference Guide (/SHUTDOWN Command parameters)

CA Workload Automation CA 7 Edition Interfaces Guide (External Communicators)