Change Autostart Job Entry (CHGAJE)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Autostart Job Entry (CHGAJE) command is used to specify a different job description for a previously defined autostart job entry in the specified subsystem description.

Notes:

  1. The job associated with an active subsystem can only find objects that exist in the system auxiliary storage pool (ASP) or in a basic user ASP. Therefore, objects that are referenced by this command should exist in the system ASP or in a basic user ASP.

Restrictions:

  1. To use this command, you must have:
    • object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing that subsystem description.
    • object operational (*OBJOPR) and read (*READ) authority to the job description and execute (*EXECUTE) authority to the library containing that job description.
  2. Only a user with all object (*ALLOBJ) special authority is allowed to change an entry for which the job description does not exist.
Top

Parameters

Keyword Description Choices Notes
SBSD Subsystem description Qualified object name Required, Positional 1
Qualifier 1: Subsystem description Name
Qualifier 2: Library Name, *LIBL, *CURLIB
JOB Job name Name Required, Positional 2
JOBD Job description Single values: *SAME, *SBSD
Other values: Qualified object name
Optional
Qualifier 1: Job description Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description containing the autostart job entry being changed.

This is a required parameter.

Qualifier 1: Subsystem description

name
Specify the name of the subsystem description where the autostart job entry is being changed. p.Note: The following IBM-supplied objects are not valid on this parameter:
  • QSYSSBSD

Qualifier 2: Library

*LIBL
All libraries in the thread's library list are searched until a match is found.
*CURLIB
The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the library where the subsystem description is located.
Top

Job name (JOB)

Specifies the simple name of the job that is automatically started when a subsystem is started using the subsystem description specified on the Subsystem description (SBSD) parameter.

This is a required parameter.

name
Specify the simple name of the job that is automatically started.
Top

Job description (JOBD)

Specifies the name of the job description used for the job that is started by this autostart job entry. If the job description does not exist when the entry is added or changed, a library qualifier must be specified because the qualified job description name is kept in the subsystem description.

Note: Only a user with all object (*ALLOBJ) special authority is allowed to add or change an entry for which the job description does not exist.

Single values

*SAME
The job description specified in the existing autostart job entry is used.
*SBSD
The job description having the same qualified name as the subsystem description, specified on the Subsystem description (SBSD) parameter, is used for the job that is being started.

Qualifier 1: Job description

name
Specify the name of the job description used for the job started by this autostart job entry.

Qualifier 2: Library

*LIBL
All libraries in the thread's library list are searched until a match is found.
*CURLIB
The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the library where the job description is located.
Top

Examples

CHGAJE   SBSD(QGPL/PAYROLL)  JOB(INIT)  JOBD(MANAGER)

This command changes autostart job entry for the job INIT to use the job description MANAGER. The autostart job entry is in the PAYROLL subsystem description in the QGPL library. The library list is used to locate the job description MANAGER. When the correct library is determined, the qualified job description name is placed in the subsystem description for this autostart job entry.

Top

Error messages

*ESCAPE Messages

CPF1619
Subsystem description &1 in library &2 damaged.
CPF1697
Subsystem description &1 not changed.
Top