Add Autostart Job Entry (ADDAJE)

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

The Add Autostart Job Entry (ADDAJE) command adds an autostart job entry to the specified subsystem description. The entry identifies the job name and the job description to be used to automatically start a job.

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 add 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: *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 where the autostart job entry is being added.

This is a required parameter.

Qualifier 1: Subsystem description

name
Specify the name of the subsystem description where the autostart job entry is being added.

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

*SBSD
The job description having the same name and library 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 that is used for the job being 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

ADDAJE   SBSD(ACCTLIB/ACCTINT) JOB(ACCTINIT) JOBD(ACCTLIB/INITSBS)

This command adds an autostart job entry for the job ACCTINIT subsystem description ACCTINT in the library ACCTLIB. In this case, the job that starts automatically might be used to perform certain routines whenever the subsystem ACCTINT is started. When the subsystem is started, the job description INITSBS in ACCTLIB is used to obtain the attributes for this job and a job named ACCTINIT is automatically started in the subsystem.

Top

Error messages

*ESCAPE Messages

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