CL Command Reference - CHGCMNE
CL Command List > CHGCMNE Reference
Description:
The Change Communications Entry (CHGCMNE) command is used to change the attributes of an existing communications entry in an existing subsystem description.
Notes:
1. When the Job description (JOBD) or Default user profile (DFTUSR) parameters are changed, the communications entry also changes; however, the values of these parameters are not changed for any jobs that are active at the time.
2. If the value of the Maximum active jobs (MAXACT) parameter is reduced to a number less than the total number of jobs that are active through the communications entry, no new program start requests are processed. Active jobs continue to run; but no additional program start requests are processed until the number of active jobs is less than the value specified for the MAXACT parameter.
3. 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. v use (*USE) authority to the user profile.
2. Only a user with all object (*ALLOBJ) special authority is allowed to change an entry for which the job description does not exist.
Examples:
CHGCMNE SBSD(QGPL/BAKER) DEV(A12) MAXACT(*NOMAX)
This command changes the communications entry (in the subsystem description QGPL/BAKER) for the device A12 and mode *ANY. The maximum activity level is changed to *NOMAX which means that the communications entry puts no restrictions on the number of program start requests that may be active at the same time. However, the MAXJOBS value in the subsystem description BAKER limits the total number of jobs that can be active in the subsystem. This includes those created by program start requests. There is also a limit that the user can specify on the number of active jobs that can be routed through any particular routing entry (MAXACT). The limit specified in the routing entry may control the number of jobs using a particular pool or the recursion level of a particular program. In all cases, none of these limits can be exceeded as a result of processing a program start request.