---

 

CHGCTLAPPC (Change Controller Description (APPC)) syntax diagram

Job: B,I Pgm: B,I REXX: B,I Exec

Threadsafe: No

                                                     (1) (2)
>>-CHGCTLAPPC--CTLD(--controller-description-name--)------------>
 
>--+-----------------------+--+------------------------+-------->
   |          .-*SAME-.    |  |           .-*SAME-.    |
   '-ONLINE(--+-*YES--+--)-'  '-ACTSNBU(--+-*NO---+--)-'
              '-*NO---'                   '-*YES--'
 
>--+---------------------+-------------------------------------->
   |        .-*SAME-.    |
   '-APPN(--+-*YES--+--)-'
            '-*NO---'
 
>--+------------------------------------------------+----------->
   |             .-*SAME-----------------------.    |
   |             | .-------------------------. |    |
   |             | V                    (3)  | |    |
   '-SWTLINLST(--+---switched-line-name------+-+--)-'
 
>--+-----------------------+------------------------------------>
   |        .-*SAME---.    |
   '-CODE(--+-*EBCDIC-+--)-'
            '-*ASCII--'
 
>--+------------------------------------------+----------------->
   |           (4) (5)   .-*SAME---------.    |
   '-MAXFRAME(-----------+-*LINKTYPE-----+--)-'
                         +-256-----------+
                         +-265-----------+
                         +-512-----------+
                         +-521-----------+
                         +-1024----------+
                         +-1033----------+
                         +-1994----------+
                         +-2048----------+
                         +-2057----------+
                         +-4060----------+
                         +-4096----------+
                         +-8156----------+
                         +-16393---------+
                         '-maximum-frame-'
 
>--+----------------------------------------------+------------->
   |            .-*SAME-------------. (6) (7)     |
   '-RMTNETID(--+-*NETATR-----------+-----------)-'
                +-*NONE-------------+
                +-*ANY--------------+
                '-remote-network-ID-'
 
>--+-------------------------------------------------------+---->
   |             .-*SAME---------------------. (7) (8)     |
   '-RMTCPNAME(--+-*NONE---------------------+-----------)-'
                 +-*ANY----------------------+
                 '-remote-control-point-name-'
 
>--+------------------------------------+----------------------->
   '-RMTSYSNAME(--remote-system-name--)-'
 
>--+---------------------------------------------------------+-->
   |          .-*SAME-----------------------------------.    |
   '-SSCPID(--+-*NONE-----------------------------------+--)-'
              '-system-service-control-point-identifier-'
 
>--+-----------------------+------------------------------------>
   |          .-*SAME-.    |
   '-INLCNN(--+-*DIAL-+--)-'
              '-*ANS--'
 
>--+----------------------------------+------------------------->
   |            .-*SAME-----.    (9)  |
   '-DIALINIT(--+-*LINKTYPE-+--)------'
                +-*IMMED----+
                '-*DELAY----'
 
>--+-----------------------------------+------------------------>
   |          .-*SAME-------------.    |
   '-CNNNBR(--+-*DC---------------+--)-'
              +-*ANY--------------+
              '-connection-number-'
 
>--+-------------------------+---------------------------------->
   |          .-*SAME---.    |
   '-ANSNBR(--+-*CNNNBR-+--)-'
              '-*ANY----'
 
>--+------------------------------------+----------------------->
   |             .-*SAME-----------.    |
   '-CNNLSTOUT(--+-connection-list-+--)-'
 
>--+-------------------------------------------+---------------->
   |              .-*SAME-----------------.    |
   '-CNNLSTOUTE(--+-connection-list-entry-+--)-'
 
>--+---------------------------------+-------------------------->
   |              .-*SAME-------.    |
   '-IDLCWDWSIZ(--+-*LIND-------+--)-'
                  '-window-size-'
 
>--+--------------------------------------+--------------------->
   |              .-*SAME------------.    |
   '-IDLCFRMRTY(--+-*LIND------------+--)-'
                  '-IDLC-frame-retry-'
 
>--+----------------------------------------+------------------->
   |              .-*SAME--------------.    |
   '-IDLCRSFTMR(--+-*LIND--------------+--)-'
                  '-IDLC-response-time-'
 
>--+-----------------------------------+------------------------>
   |              .-*SAME---------.    |
   '-IDLCCNNRTY(--+-*LIND---------+--)-'
                  +-*NOMAX--------+
                  '-connect-retry-'
 
>--+-----------------------------------+------------------------>
   |              .-*SAME---------.    |
   '-PREDIALDLY(--+-predial-delay-+--)-'
 
>--+---------------------------------+-------------------------->
   |             .-*SAME--------.    |
   '-REDIALDLY(--+-redial-delay-+--)-'
 
>--+-----------------------------+--+-----------------------+--->
   |           .-*SAME------.    |  |          .-*SAME-.    |
   '-DIALRTY(--+-dial-retry-+--)-'  '-SWTDSC(--+-*YES--+--)-'
                                               '-*NO---'
 
>--+------------------------------------------------------------------+-->
   |          .-*SAME--------------------------------------------.    |
   '-DSCTMR(--+---disconnect-timer------disconnect-delay-timer---+--)-'
 
>--+-----------------------------------------+------------------>
   |             .-*SAME----------------.    |
   '-SHMDSCLMT(--+-*NOMAX---------------+--)-'
                 '-SHM-disconnect-limit-'
 
>--+-----------------------------------------+------------------>
   |             .-*SAME----------------.    |
   '-SHMDSCTMR(--+-SHM-disconnect-timer-+--)-'
 
>--+---------------------------------+-------------------------->
   |          .-*SAME-----------.    |
   '-STNADR(--+-station-address-+--)-'
 
>--+------------------------+----------------------------------->
   |           .-*SAME-.    |
   '-POLLPTY(--+-*NO---+--)-'
               '-*YES--'
 
>--+-----------------------------+------------------------------>
   |           .-*SAME------.    |
   '-POLLLMT(--+-poll-limit-+--)-'
 
>--+---------------------------+-------------------------------->
   |          .-*SAME-----.    |
   '-OUTLMT(--+-*POLLLMT--+--)-'
              '-out-limit-'
 
>--+----------------------------------------+------------------->
   |              .-*SAME--------------.    |
   '-CNNPOLLRTY(--+-*CALC--------------+--)-'
                  +-*NOMAX-------------+
                  '-connect-poll-retry-'
 
>--+------------------------------------+----------------------->
   |              .-*SAME----------.    |
   '-NDMPOLLTMR(--+-*CALC----------+--)-'
                  '-NDM-poll-timer-'
 
>--+----------------------------------+------------------------->
   |           .-*SAME-----------.    |
   '-ADPTADR(--+-adapter-address-+--)-'
 
>--+------------------------------------------------+----------->
   |        .-*SAME----------------------------.    |
   '-DSAP(--+-destination-service-access-point-+--)-'
 
>--+-------------------------------------------+---------------->
   |        .-*SAME-----------------------.    |
   '-SSAP(--+-source-service-access-point-+--)-'
 
>--+------------------------------------+----------------------->
   |             .-*SAME-----------.    |
   '-LANFRMRTY(--+-*CALC-----------+--)-'
                 '-LAN-frame-retry-'
 
>--+-----------------------------------------+------------------>
   |             .-*SAME----------------.    |
   '-LANCNNRTY(--+-*CALC----------------+--)-'
                 '-LAN-connection-retry-'
 
>--+---------------------------------------+-------------------->
   |             .-*SAME--------------.    |
   '-LANRSPTMR(--+-*CALC--------------+--)-'
                 '-LAN-response-timer-'
 
>--+-----------------------------------------+------------------>
   |             .-*SAME----------------.    |
   '-LANCNNTMR(--+-*CALC----------------+--)-'
                 '-LAN-connection-timer-'
 
>--+---------------------------------------------+-------------->
   |             .-*SAME--------------------.    |
   '-LANACKTMR(--+-*CALC--------------------+--)-'
                 '-LAN-acknowledgment-timer-'
 
>--+------------------------------------------+----------------->
   |              .-*SAME----------------.    |
   '-LANINACTMR(--+-*CALC----------------+--)-'
                  '-LAN-inactivity-timer-'
 
>--+-------------------------------------------------+---------->
   |             .-*SAME------------------------.    |
   '-LANACKFRQ(--+-*CALC------------------------+--)-'
                 '-LAN-acknowledgment-frequency-'
 
>--+---------------------------------------------------+-------->
   |             .-*SAME--------------------------.    |
   '-LANMAXOUT(--+-*CALC--------------------------+--)-'
                 '-LAN-maximum-outstanding-frames-'
 
>--+----------------------------------------+------------------->
   |             .-*SAME---------------.    |
   '-LANACCPTY(--+-*CALC---------------+--)-'
                 '-LAN-access-priority-'
 
>--+------------------------------------+----------------------->
   |             .-*SAME-----------.    |
   '-LANWDWSTP(--+-*NONE-----------+--)-'
                 '-LAN-window-step-'
 
>--+-----------------------+--+------------------------+-------->
   |          .-*SAME-.    |  |           .-*SAME-.    |
   '-NETLVL(--+-1980--+--)-'  '-LINKPCL(--+-*QLLC-+--)-'
              +-1984--+                   +-*ELLC-+
              '-1988--'                   '-*LLC2-'
 
>--+------------------------------------------+----------------->
   |          .-*SAME--------------------.    |
   '-CNNPWD(--+-*NONE--------------------+--)-'
              '-X.25-connection-password-'
 
>--+----------------------------+------------------------------->
   |              .-*SAME--.    |
   '-SWTLINSLCT(--+-*FIRST-+--)-'
                  '-*CALC--'
 
>--+-------------------------------------------------------------------+-->
   |              .-*SAME----------------.  .-*SAME---------------.    |
   '-DFTPKTSIZE(--+-*LIND----------------+--+-*LIND---------------+--)-'
                  '-transmit-packet-size-'  +-*TRANSMIT-----------+
                                            '-receive-packet-size-'
 
>--+---------------------------------------------------------------------------+-->
   |              .-*SAME--------------------.  .-*SAME-------------------.    |
   '-DFTWDWSIZE(--+-*LIND--------------------+--+-*LIND-------------------+--)-'
                  '-max-transmit-window-size-'  +-*TRANSMIT---------------+
                                                '-max-receive-window-size-'
 
>--+--------------------------------------+--------------------->
   |            .-*SAME--------------.    |
   '-USRGRPID(--+-*NONE--------------+--)-'
                '-X.25-user-group-ID-'
 
>--+--------------------------+--------------------------------->
   |          .-*SAME----.    |
   '-RVSCRG(--+-*NONE----+--)-'
              +-*REQUEST-+
              +-*ACCEPT--+
              '-*BOTH----'
 
>--+-------------------------------------+---------------------->
   |             .-*SAME------------.    |
   '-X25FRMRTY(--+-X.25-frame-retry-+--)-'
 
>--+------------------------------------------+----------------->
   |             .-*SAME-----------------.    |
   '-X25CNNRTY(--+-X.25-connection-retry-+--)-'
 
>--+----------------------------------------+------------------->
   |             .-*SAME---------------.    |
   '-X25RSPTMR(--+-X.25-response-timer-+--)-'
 
>--+------------------------------------------+----------------->
   |             .-*SAME-----------------.    |
   '-X25CNNTMR(--+-X.25-connection-timer-+--)-'
 
>--+--------------------------------------------------+--------->
   |             .-*SAME-------------------------.    |
   '-X25DLYTMR(--+-*CALC-------------------------+--)-'
                 '-X.25-delayed-connection-timer-'
 
>--+----------------------------------------------+------------->
   |             .-*SAME---------------------.    |
   '-X25ACKTMR(--+-X.25-acknowledgment-timer-+--)-'
 
>--+-------------------------------------------+---------------->
   |              .-*SAME-----------------.    |
   '-X25INACTMR(--+-X.25-inactivity-timer-+--)-'
 
>--+---------------------------------+-------------------------->
   |          .-*SAME-----------.    |
   '-USRFCL(--+-*NONE-----------+--)-'
              '-user-facilities-'
 
>--+----------------------+------------------------------------->
   |         .-*SAME-.    |
   '-CPSSN(--+-*YES--+--)-'
             '-*NO---'
 
>--+----------------------------------+------------------------->
   |           (10)   .-*SAME----.    |
   '-NODETYPE(--------+-*CALC----+--)-'
                      +-*NETNODE-+
                      +-*ENDNODE-+
                      '-*LENNODE-'
 
>--+---------------------------------+-------------------------->
   |           .-*SAME----.    (11)  |
   '-BEXROLE(--+-*NETNODE-+--)-------'
               '-*ENDNODE-'
 
>--+--------------------------+--------------------------------->
   |       .-*SAME-.    (11)  |
   '-HPR(--+-*YES--+--)-------'
           '-*NO---'
 
>--+--------------------------------+--------------------------->
   |             .-*SAME-.    (12)  |
   '-HPRPTHSWT(--+-*NO---+--)-------'
                 '-*YES--'
 
>--+---------------------------------------------------------+-->
   |            (10)   .-*SAME--------------------------.    |
   '-TMSGRPNBR(--------+-*CALC--------------------------+--)-'
                       '-APPN-transmission-group-number-'
 
>--+------------------------------+----------------------------->
   '-MINSWTSTS(--+-*SAME-----+--)-'
                 +-*VRYONPND-+
                 '-*VRYON----'
 
>--+---------------------------+-------------------------------->
   |              .-*SAME-.    |
   '-AUTOCRTDEV(--+-*ALL--+--)-'
                  '-*NONE-'
 
>--+-------------------------------+---------------------------->
   |              .-*SAME-----.    |
   '-AUTODLTDEV(--+-1440------+--)-'
                  +-*NO-------+
                  '-wait-time-'
 
>--+---------------------------------+-------------------------->
   |           .-*SAME----------.    |
   '-USRDFN1(--+-*LIND----------+--)-'
               '-user-defined-1-'
 
>--+---------------------------------+-------------------------->
   |           .-*SAME----------.    |
   '-USRDFN2(--+-*LIND----------+--)-'
               '-user-defined-2-'
 
>--+---------------------------------+-------------------------->
   |           .-*SAME----------.    |
   '-USRDFN3(--+-*LIND----------+--)-'
               '-user-defined-3-'
 
>--+-----------------------------------------------+------------>
   |             .-*SAME----------------------.    |
   '-CMNRCYLMT(--+-*SYSVAL--------------------+--)-'
                 '-count-limit--time-interval-'
 
>--+-----------------------+------------------------------------>
   |          .-*SAME-.    |
   '-MDLCTL(--+-*NO---+--)-'
              '-*YES--'
 
>--+-------------------------------------------------+---------->
   |            .-*SAME-------------------------.    |
   '-CNNNETID(--+-*NETATR-----------------------+--)-'
                +-*NONE-------------------------+
                '-connection-network-network-ID-'
 
>--+--------------------------------------------------+--------->
   |             .-*SAME-------------------------.    |
   '-CNNCPNAME(--+-*NONE-------------------------+--)-'
                 '-connection-control-point-name-'
 
>--+-----------------------+------------------------------------>
   |          .-*SAME-.    |
   '-CTLOWN(--+-*USER-+--)-'
 
>--+-----------------------------------------------+------------>
   |        .-*SAME---------------------------.    |
   '-MSGQ(--+-*SYSVAL-------------------------+--)-'
            +-*SYSOPR-------------------------+
            '-library-name/message-queue-name-'
 
>--+---------------------------------+-------------------------><
   |        .-*SAME-------------.    |
   '-TEXT(--+-*BLANK------------+--)-'
            '-'--description--'-'
 
 

Notes:

1. All parameters preceding this point can be specified in positional form.

2. All parameters preceding this point are key parameters.

3. A maximum of 64 repetitions.

4. If the LINKTYPE is *LAN or *TRLAN, valid values ranging from 265 through 16393.

5. For DDI LANs, valid values range from 265 through 4444.

6. If RMTNETID(*ANY) is specified, RMTCPNAME(*ANY) must also be specified.

7. If LINKTYPE is *ANYNW, *NONE is not allowed.

8. RMTCPNAME(*ANY) cannot be specified if LINKTYPE is *IDLC and SWITCHED or SNBU is *YES; if LINKTYPE is *SDLC and SWITCHED or SNBU is *YES; if NODETYPE is *LENNODE; or if MDLCTL is *YES; RMTCPNAME(*ANY) cannot be specified for LINKTYPE(*ANYNW).

9. This parameter is valid only if INLCNN(*DIAL) is specified.

10. If LINKTYPE is *ANYNW, the valid values for the NODETYPE and TMSGRPNBR parameters are *LENNODE and 1, respectively.

11. This parameter is valid only if APPN(*YES) is specified.

12. This parameter is valid only if HPR(*YES) is specified.