CHGPJE (Change Prestart Job Entry)

CHGPJE Command syntax diagram

 

Purpose

The Change Prestart Job Entry (CHGPJE) command changes a prestart job entry in the specified subsystem description. The associated subsystem may be active when the prestart job entry is changed. Changes made to the entry when the subsystem is active are reflected over time. New prestart jobs created after the command is issued use the new job-related values. This command identifies prestart jobs that are started when the subsystem is started.

Restriction: This command is restricted to a user with *USE and object management authorities for the subsystem description and *USE authority for the user profile and the job description.

 

Required Parameters

SBSD
Specifies the qualified name of the subsystem description that contains the prestart job entry being changed.

The name of the subsystem description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

subsystem-description-name: Specify the name of the subsystem description that contains the prestart job entry.

PGM
Specifies the qualified name of the program that identifies the prestart job entry being changed. This program name is used to match an incoming request with an available prestart job. Two entries with the same program name can exist in a single subsystem description, but they must have different library names. If the program does not exist when the entry is added, a library qualifier must be specified because the qualified name is retained in the subsystem description.

The name of the program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

program-name: Specify the name of the program.

 

Optional Parameters

USER
Specifies the user profile under which the prestart job is initiated. In addition, the current user profile of the prestart job is set to this user whenever the job waits for a request to handle.

Note: When a prestart job is given a request to handle, the current user profile of the job is updated. Refer to the Work Management guide for information on how this profile is determined. This change in current user profile is for authority checking only. None of the other attributes of the user profile, such as the current library (CURLIB) or the initial program to call (INLPGM), are given to the prestart job.

*SAME: The value of this parameter does not change.

user-profile-name: Specify the name of the user profile used for the prestart job.

JOB
Specifies the name of the prestart job that is started.

*SAME: The value does not change.

*PGM: The job name is the same name as the program name, specified by the PGM parameter.

job-name: Specify the name of the prestart job.

JOBD
Specifies the qualified name of the job description being used for the prestart job. If the job description does not exist when the entry is changed, a library qualifier must be specified because the qualified job description name is retained in the subsystem description.

*SAME: The value does not change.

*USRPRF: The job description name specified in the user profile, which was named in the USER parameter, is used.

*SBSD: The job description having the same name as the subsystem description named in the SBSD parameter is used.

The name of the job description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

job-description-name: Specify the name of the job description being used for this prestart job. If no library is specified, the library list (*LIBL) of the job where this command is run is used to find the job description.

STRJOBS
Specifies whether prestart jobs are started when the subsystem is started.

*SAME: The value does not change.

*YES: The prestart jobs are started when the subsystem is started.

*NO: The prestart jobs are not started at the time the subsystem is started. The Start Prestart Jobs (STRPJ) command must be used to start these prestart jobs.

INLJOBS
Specifies the initial number of prestart jobs that are started when the subsystem specified in the SBSD parameter is started.

 

Notes

  1. The value of this parameter must be less than or equal to the value of the MAXJOBS parameter.

  2. The value of this parameter must be greater than or equal to the value of the THRESHOLD parameter.

*SAME: The value does not change.

initial-active-jobs: Specify the number of prestart jobs that are started when the subsystem is started. Valid values range from 1 through 9999.

THRESHOLD
Specifies when additional prestart jobs are started. When the pool of available prestart jobs (jobs available to service requests) is reduced below this number, more jobs (specified by the ADLJOBS parameter) are started and added to the available pool.

Note: The value of this parameter must be less than or equal to the value of the INLJOBS parameter.

*SAME: The value does not change.

threshold-value: Specify the minimum number of prestart jobs that must be available before additional prestart jobs are started. Valid values range from 1 through 9999.

ADLJOBS
Specifies the additional number of prestart jobs that are started when the number of prestart jobs drops below the THRESHOLD parameter.

Note: The value of this parameter must be less than the value of the MAXJOBS parameter.

*SAME: The value does not change.

additional-active-jobs: Specify the number of additional prestart jobs to start. Valid values range from 0 through 999.

MAXJOBS
Specifies the maximum number of prestart jobs that can be active at the same time for this prestart job entry.

 

Notes

  1. The value of this parameter must be greater than or equal to the value of the INLJOBS parameter.

  2. The value of this parameter must be greater than the value of the ADLJOBS parameter.

  3. If the value specified for this parameter is changed, the value specified for the CLS parameter might also need to be changed.

*SAME: The value does not change.

*NOMAX: There is no maximum number of jobs that can be active at the same time.

maximum-jobs: Specify the maximum number of prestart jobs that can be active at the same time. Valid values range from 1 through 9999.

MAXUSE
Specifies the maximum number of requests that can be handled by each prestart job before the subsystem ends the job in a controlled manner by issuing an ENDJOB command with a value of *CNTRLD on the OPTION parameter.

*SAME: The value does not change.

Note: If *NOMAX is specified, the prestart jobs may end abnormally because the job has exceeded the allowed maximum job log size, the maximum number of spool files, the maximum CPU time, or the maximum temporary storage space required.

*NOMAX: There is no maximum number of jobs that can be active at the same time.

maximum-uses: Specify the maximum number of requests that a prestart job can handle before it is ended. Valid values range from 1 through 1000.

WAIT
Specifies whether program start requests wait for a prestart job to become available or are rejected if a prestart job is not immediately available when the program start request is received.

Note: See the CL Programming book for the time-out considerations for each communications type.

*SAME: The value does not change.

*YES: Program start requests wait until there is either an available prestart job, or until a prestart job is started, to service the request.

*NO: Program start requests are rejected if a prestart job is not immediately available when the program start request is received.

POOLID
Specifies the subsystem pool identifier under which the prestart jobs are run.

*SAME: The value does not change.

pool-identifier: Specify the subsystem pool identifier under which prestart jobs run. Valid values range from 1 through 10.

CLS
Specifies the names of the classes under which the prestart jobs run and how many prestart jobs are allowed to run under each class. Jobs start by using the first class. After the number of jobs specified for the first class is reached, jobs are started under the second class. If the class does not exist when the entry is added, a library qualifier must be specified because the qualified class name is retained in the subsystem description.

Note: If the value specified for the MAXJOBS parameter is changed, the value for the number of jobs specified for this parameter might need to be changed. If *CALC or *MAXJOBS is specified, the system recalculates the value for the number of jobs to use the specified class.

Element 1: Class Name of First Class

*SAME: The value does not change.

*SBSD: The class having the same name as the subsystem description specified in the SBSD parameter is used for prestart jobs.

The name of the class can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

class-name: Specify the name of the class being used for prestart jobs. If no library qualifier is specified, the library list (*LIBL) of the job in which the CHGPJE command is run is used to find the class.

Element 2: Number of Jobs Using First Class

*SAME: The value does not change.

*CALC: The system calculates how many prestart jobs use this class. If one class is specified and *CALC is specified, all of the jobs use the specified class. If two classes are specified and *CALC is specified for both, the first class is the value of the MAXJOBS parameter divided by two, and the second class is the value of the MAXJOBS parameter minus the value calculated for the first class. If a specific number of jobs is specified for one class and *CALC is specified for the other class, the system calculates the difference between MAXJOBS and the specific number of jobs for the *CALC designation.

*MAXJOBS: All prestart jobs use the specified class.

number-of-jobs: Specify the number of jobs that use this class. The value specified for both classes must total the value specified for the MAXJOBS parameter.

Element 3: Class Name of Second Class

*SAME: The value does not change.

*NONE: This value indicates that only one class is used.

*SBSD: The class having the same name as the subsystem description, specified on the SBSD parameter, is used for prestart jobs.

The name of the class can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

class-name: Specify the name of the class being used for prestart jobs. If no library qualifier is specified, the library list (*LIBL) of the job where the CHGPJE command is run is used to find the class.

Element 4: Number of Jobs Using Second Class

*SAME: The value does not change.

*CALC: The system calculates how many prestart jobs use this class. If one class is specified and *CALC is specified, all of the jobs use the specified class. If two classes are specified and *CALC is specified for both, the first class is the value of the MAXJOBS parameter divided by two, and the second class is the value of the MAXJOBS parameter minus the value calculated for the first class. If a specific number of jobs is specified for one class and *CALC is specified for the other class, the system calculates the difference between MAXJOBS and the specific number of jobs for the *CALC designation.

*MAXJOBS: All prestart jobs use the specified class.

number-of-jobs: Specify the number of jobs that use this class. The value specified for both classes must total the value specified for the MAXJOBS parameter.

Example for CHGPJE 

CHGPJE  SBSD(QGPL/PJSBS)  PGM(QGPL/PGM1)  STRJOBS(*NO)
  THRESHOLD(1)  ADLJOBS(1)

This command changes the prestart job entry for the PGM1 program in the QGPL library in the PJSBS subsystem description contained in the QGPL library. The prestart jobs associated with this entry are not started the next time the PJSBS subsystem description in the QGPL library is started. The STRPJ command is needed to start the prestart jobs. When more jobs need to be started, one additional job is started.

Error messages for CHGPJE

*ESCAPE Messages

CPF1619
Subsystem description &1 in library &2 damaged.
CPF1691
Active subsystem description may or may not have changed.
CPF1697
Subsystem description &1 not changed.