Troubleshooting
Problem
This document describes the limitations of running the RCLSTG command in a batch restricted state.
Resolving The Problem
Starting at V5R3M0, it is now possible to run batch jobs to QCTL in a restricted state. The intent is to run scheduled restricted state saves without a console. To do this, the ENDSBS command has a new BCHTIMLMT parameter.
It is possible to run RCLSTG in batch restricted mode; however, it is not recommended.
One of the main concerns is how can a user can be sure of the time that the RCLSTG will take to run. If the user specifies 60 minutes for the restricted state batch time limit and the RCLSTG requires more than an hour to complete, the batch job is ended and the controlling subsystem restarted. The consequences of this affect the system integrity.
If the user wants to run the RCLSTG command this way, *NOMAX can be specified for the BCHTIMLMT parameter. Then, the system remains in the restricted state until the job ends or until the RCLSTG command completes. The BCHTIMLMT parameter Help text indicates that if the client runs out of time prior to the RCLSTG command completing, use Dedicated Service Tools (DST) to end batch restricted state.
Example:
PGM
QSYS/ENDSBS SBS(*ALL) OPTION(*IMMED) BCHTIMLMT(*NOMAX)
DLYJOB DLY(120)
QSYS/RCLSTG
MONMSG MSGID(CPF0000) EXEC(GOTO CMDLBL(START))
START: QSYS/STRSBS SBSD(QCTL)
RETURN
ENDPGM
Notes:
| 1 | It is not possible to answer messages. |
| 2 | While the RCLSTG is running, the console will be blank with the cursor in the upper right corner. |
| 3 | While the system is in batch restricted state, SRCA9003C70 is displayed on the operator panel. If the job is still in restricted state when the specified time limit is reached, the batch job is ended and the controlling subsystem is restarted. |
| 4 | To cancel a RCLSTG, force DST (Option 21 from the operator panel) and then select Option 14 - End Restricted State Batch. |
| 5 | If a RCLSTG SELECT(*ALL) OMIT(*NONE) is terminated before it completes, RCLSTG SELECT(*DBXREF) must be run. |
| 6 | To change the RCLSTG command to allow it to run in batch mode, type the following: CHGCMD CMD(RCLSTG) ALLOW(*IREXX *IPGM *EXEC *INTERACT *BPGM) Press the Enter key. |
Historical Number
386114611
Was this topic helpful?
Document Information
Modified date:
18 December 2019
UID
nas8N1015438