CL Command Reference - ADDCMNE

CL Command List > ADDCMNE Reference

Description:

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.

Notes:

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.
. use (*USE) authority to the user profile.

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

3. A subsystem cannot allocate a communications device that is currently allocated to another subsystem or job.



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.