Add Communications Entry (ADDCMNE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add Communications Entry (ADDCMNE) command adds a communications entry to an existing subsystem description. Each communications entry describes one or more communications devices, device types, or remote locations for which the subsystem will start jobs when program start requests are received. The subsystem can allocate a communications device if the device is not currently allocated to another subsystem or job. A communications device that is currently allocated may eventually be de-allocated, making it available to other subsystems.
Restrictions:
- 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.
- use (*USE) authority to the user profile.
- Only a user with all object (*ALLOBJ) special authority is allowed to add an entry for which the job description does not exist.
- A subsystem cannot allocate a communications device that is currently allocated to another subsystem or job.
| 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 | ||
| DEV | Device | Generic name, name, *ALL, *APPC, *ASYNC, *BSCEL, *FINANCE, *INTRA, *RETAIL, *SNUF | Optional, Positional 2 |
| RMTLOCNAME | Remote location | Communications name | Optional, Positional 3 |
| JOBD | Job description | Single values: *USRPRF, *SBSD Other values: Qualified object name |
Optional, Positional 4 |
| Qualifier 1: Job description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| DFTUSR | Default user profile | Name, *NONE, *SYS | Optional |
| MODE | Mode | Communications name, *ANY | Optional |
| MAXACT | Maximum active jobs | 0-32000, *NOMAX | Optional |
| Top |
Subsystem description (SBSD)
Specifies the name and library of the subsystem description to which the communications entry is being added or in which it is being changed.
This is a required parameter.
Qualifier 1: Subsystem description
- name
- Specify the name of the subsystem to which the communications entry is being added.
Note: The IBM-supplied object QSYSSBSD is not valid on this parameter.
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 name of the subsystem description's library to which the communications entry is being added.
| Top |
Device (DEV)
Specifies the name of the device description or the type of the device being used with this communications entry.
Note: You must specify a value on either this parameter or the Remote location (RMTLOCNAME) parameter, but not both.
- *ALL
- All communications device types or names can be used with this communications entry.
- *APPC
- All advanced program-to-program communications devices can be used with this communications entry. The devices created with the Create Device Desc (APPC) (CRTDEVAPPC) command can be used.
- *ASYNC
- All asynchronous communications devices can be used with this communications entry. The devices created with the Create Device Desc (Async) (CRTDEVASC) command can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
- *BSCEL
- All bisynchronous equivalency link communications devices can be used with this communications entry. The devices created with the Create Device Desc (BSC) (CRTDEVBSC) command can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
- *FINANCE
- Specifies that all finance communications devices can be used with this communication entry. The devices created with the Create Device Desc (Finance) (CRTDEVFNC) command can be used by this communications entry. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
- *INTRA
- All INTRA communications devices can be used with this communications entry. The devices created with the Create Device Create Device Desc (Intra) (CRTDEVINTR) command can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
- *RETAIL
- All retail communications devices can be used with this communications entry. The devices created with the Create Device Desc (Retail) (CRTDEVRTL) command can be used by this communications entry. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
- *SNUF
- All SNA upline facility communications devices can be used with this communications entry. The devices created with the Create Device Desc (SNUF) (CRTDEVSNUF) command are can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
- generic-name
- Specify the generic name of the device description used with this communications entry.
- name
- Specify the device description used with this communications entry.
| Top |
Remote location (RMTLOCNAME)
Specifies the name of the remote location used with this communications entry. The remote location name specified in the associated device description can be used here. No validity checking is done on the remote location name.
Note: You must specify a value for either this parameter or the Device (DEV) parameter, but not for both.
- communications-name
- Specify the name of the remote location used with this communications entry.
| Top |
Job description (JOBD)
Specifies the name and library of the job description used for jobs that are started as a result of receiving a program start request, and that are processed through this communications 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
- *USRPRF
- The job description name that is specified in the user profile of the user that made the program start request is used for jobs that are started through this communications entry.
- *SBSD
- The job description having the same name as the subsystem description, specified on the Subsystem description (SBSD) parameter, is used for jobs started through this communications entry.
Qualifier 1: Job description
- name
- Specify the name of the job description that is used for jobs started through this communications 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 |
Default user profile (DFTUSR)
Specifies the default user profile used for a program start request that contains no security information. This user profile is not used for program start requests that contain a password or specify a user profile (either valid or not valid).
- *NONE
- No user profile is specified as the default.
- *SYS
- All user program start requests will be treated the same as *NONE. For program start requests sent by system functions, the request will run under a predetermined user profile if a user profile is not specified on the program start request.
- name
- Specify the name of the user profile that is used for all program start requests that enter the system through this communications entry and that contain no password or user profile name.
Note: The names QDFTOWN, QLPINSTALL, QSECOFR, QSPL, QDOC, QDBSHR, QRJE, QTSTRQS, and QSYS are not valid entries for this parameter.
| Top |
Mode (MODE)
Specifies the mode name of the communications device or remote location name whose communications entry is being added or changed.
- *ANY
- Any available modes defined to the communications device or remote location are allocated to the subsystem. If the communications device does not have defined modes associated with it, the communications device itself is allocated to the subsystem.
- name
- Specify the mode name of the communications device or remote location name that is being added or changed.
Note: The names SNASVCMG and CPSVCMG are not valid for this parameter.
| Top |
Maximum active jobs (MAXACT)
Specifies the maximum number of jobs (received program start requests) that can be active at the same time through this communications entry.
- *NOMAX
- There is no maximum number of jobs that can be active at the same time through this communications entry.
- 1-32000
- Specify the maximum number of jobs that can be active at the same time through this communications entry.
| Top |
Examples
ADDCMNE SBSD(ALIB/SBS1) DEV(COMDEV)
This command adds a communications entry for the APPC device named COMDEV and mode *ANY to the subsystem description SBS1, which resides in library ALIB. The DFTUSR parameter defaults to *NONE, which means that no jobs may enter the system through this entry unless valid security information is supplied on the program start request.
| Top |
Error messages
*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.
| Top |