MSGQSH001-0012 is Received When Attempting to Execute a Qshell Command

Problem

The execution of a CL program in batch which in turn executes a Qshell command fails with QSH001-0012 - error found starting child process, system resources not available.

This error message indicates the maximum number of jobs set on the subsystem description under operational attributes is not large enough to allow for the Qshell and child processes to run. In this case, the subsystem was QBATCH. The subsystem description indicated that only a limited number of jobs could run in the subsystem. Because the maximum number of jobs was already allocated, a QP0ZSPWP job could not be started.

Any Qshell command that is run requires three jobs to execute:

1. One for the device or program job (for example, QPADEV*)
2. One for the qshell interpreter (for example, QZSHSH)
3. One for the child process that executes the command (for example, QP0ZSPWP/QP0ZSPWT)

Solution

The maximum number of jobs set on the subsystem description needs to be increased to allow additional jobs to be allocated. This can be done through the commands below.

CHGSBSD SBSD(Subsystem) MAXJOBS(n+3) where n = current MAXJOBS
or
CHGSBSD SBSD(Subsystem) MAXJOBS(*NOMAX)

Note: This will change the setting to no maximum.

You might also need to increase the maximum active jobs allowed in the job queue assigned to the subsystem as well. To find the job queue assigned to the subsystem, execute the DSPSBSD command and select Option 6 to view the job queue entries. If the maximum active jobs needs to be changed for the job queue, execute the CHGJOBQE command to increase the MAXACT parameter:

CHGJOBQE SBSD(QBATCH) JOBQ(QGPL/QBATCH) MAXACT(*NOMAX) SEQNBR(10)

This command will increase the maximum active jobs allowed in the job queue to *NOMAX for the QGPL/QBATCH job queue assigned to the subsystem QBATCH.