---

 

CHGCTLHOST (Change Controller Description (SNA Host)) syntax diagram

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

Threadsafe: No

                                                     (1) (2)
>>-CHGCTLHOST--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)     |
   '-RMTNETID(--+-*NETATR-----------+-------)-'
                +-*NONE-------------+
                +-*ANY--------------+
                '-remote-network-ID-'
 
>--+---------------------------------------------------+-------->
   |             .-*SAME---------------------. (7)     |
   '-RMTCPNAME(--+-*NONE---------------------+-------)-'
                 +-*ANY----------------------+
                 '-remote-control-point-name-'
 
>--+----------------------------------------------------+------->
   |             .-*SAME----------------------. (8)     |
   '-ADJLNKSTN(--+-*NONE----------------------+-------)-'
                 +-*ANY-----------------------+
                 '-adjacent-link-station-name-'
 
>--+---------------------------------------------------------+-->
   |          .-*SAME-----------------------------------.    |
   '-SSCPID(--+-*NONE-----------------------------------+--)-'
              '-system-service-control-point-identifier-'
 
>--+-----------------------+------------------------------------>
   |          .-*SAME-.    |
   '-INLCNN(--+-*ANS--+--)-'
              '-*DIAL-'
 
>--+----------------------------------+------------------------->
   |            .-*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------------+--)-'
                  '-IDLC-window-size-'
 
>--+------------------------------------+----------------------->
   |              .-*SAME----------.    |
   '-IDLCFRMRTY(--+-*LIND----------+--)-'
                  '-IDLC-max-retry-'
 
>--+-----------------------------------------+------------------>
   |              .-*SAME---------------.    |
   '-IDLCRSPTMR(--+-*LIND---------------+--)-'
                  '-IDLC-response-timer-'
 
>--+----------------------------------------+------------------->
   |              .-*SAME--------------.    |
   '-IDLCCNNRTY(--+-*LIND--------------+--)-'
                  +-*NOMAX-------------+
                  '-IDLC-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-----------.    |
   '-STNADR(--+-station-address-+--)-'
 
>--+----------------------------------+------------------------->
   |           .-*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-acknowledgement-timer-'
 
>--+------------------------------------------+----------------->
   |              .-*SAME----------------.    |
   '-LANINACTMR(--+-*CALC----------------+--)-'
                  '-LAN-inactivity-timer-'
 
>--+--------------------------------------------------+--------->
   |             .-*SAME-------------------------.    |
   '-LANACKFRQ(--+-*CALC-------------------------+--)-'
                 '-LAN-acknowledgement-frequency-'
 
>--+---------------------------------------------------+-------->
   |             .-*SAME--------------------------.    |
   '-LANMAXOUT(--+-*CALC--------------------------+--)-'
                 '-LAN-maximum-outstanding-frames-'
 
>--+----------------------------------------+------------------->
   |             .-*SAME---------------.    |
   '-LANACCPTY(--+-*CALC---------------+--)-'
                 '-LAN-access-priority-'
 
>--+-----------------------------------------+------------------>
   |             .-*SAME----------------.    |
   '-LANWDWSTP(--+-*NONE----------------+--)-'
                 '-LAN-number-of-frames-'
 
>--+-----------------------+--+------------------------+-------->
   |          .-*SAME-.    |  |           .-*SAME-.    |
   '-NETLVL(--+-1980--+--)-'  '-LINKPCL(--+-*QLLC-+--)-'
              +-1984--+                   '-*ELLC-'
              '-1988--'
 
>--+------------------------------------------+----------------->
   |          .-*SAME--------------------.    |
   '-CNNPWD(--+-*NONE--------------------+--)-'
              '-X.25-connection-password-'
 
>--+----------------------------+------------------------------->
   |              .-*SAME--.    |
   '-SWTLINSLCT(--+-*FIRST-+--)-'
                  '-*CALC--'
 
>--+-------------------------------------------------------------------+-->
   |              .-*SAME----------------.  .-*SAME---------------.    |
   '-DFTPKTSIZE(--+-*LIND----------------+--+---------------------+--)-'
                  '-transmit-packet-size-'  +-*TRANSMIT-----------+
                                            +-*LIND---------------+
                                            '-receive-packet-size-'
 
>--+---------------------------------------------------------------------------+-->
   |              .-*SAME--------------------.  .-*SAME-------------------.    |
   '-DFTWDWSIZE(--+-*LIND--------------------+--+-------------------------+--)-'
                  '-max-transmit-window-size-'  +-*TRANSMIT---------------+
                                                +-*LIND-------------------+
                                                '-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---------------.    |
   '-X25RSPTMR(--+-X.25-response-timer-+--)-'
 
>--+-----------------------------------------------+------------>
   |             .-*SAME----------------------.    |
   '-X25ACKTMR(--+-X.25-acknowledgement-timer-+--)-'
 
>--+-------------------------------------------+---------------->
   |              .-*SAME-----------------.    |
   '-X25INACTMR(--+-X.25-inactivity-timer-+--)-'
 
>--+---------------------------------+-------------------------->
   |          .-*SAME-----------.    |
   '-USRFCL(--+-*NONE-----------+--)-'
              '-user-facilities-'
 
>--+----------------------+--+----------------------------+----->
   |         .-*SAME-.    |  |            .-*SAME----.    |
   '-CPSSN(--+-*YES--+--)-'  '-NODETYPE(--+-*CALC----+--)-'
             '-*NO---'                    +-*NETNODE-+
                                          +-*ENDNODE-+
                                          '-*LENNODE-'
 
>--+---------------------------------+-------------------------->
   |           .-*SAME----.    (10)  |
   '-BEXROLE(--+-*NETNODE-+--)-------'
               '-*ENDNODE-'
 
>--+--------------------------+--------------------------------->
   |       .-*SAME-.    (11)  |
   '-HPR(--+-*YES--+--)-------'
           '-*NO---'
 
>--+--------------------------------+--------------------------->
   |             .-*SAME-.    (12)  |
   '-HPRPTHSWT(--+-*NO---+--)-------'
                 '-*YES--'
 
>--+---------------------------------------------------+-------->
   |             .-*SAME--------------------------.    |
   '-TMSGRPNBR(--+-*CALC--------------------------+--)-'
                 '-APPN-transmission-group-number-'
 
>--+------------------------------+----------------------------->
   |             .-*SAME-----.    |
   '-MINSWTSTS(--+-*VRYONPND-+--)-'
                 '-*VRYON----'
 
>--+------------------------------+----------------------------->
   |              .-*SAME----.    |
   '-AUTOCRTDEV(--+-*ALL-----+--)-'
                  +-*DEVINIT-+
                  '-*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-----------------------------.    |
   '-PRIDLUS(--+-*NONE-----------------------------+--)-'
               |                    .-*NETATR----. |
               '-primary-DLUS-name--+-network-ID-+-'
 
>--+---------------------------------------------------+-------->
   |           .-*SAME----------------------------.    |
   '-BKUDLUS(--+-*NONE----------------------------+--)-'
               |                   .-*NETATR----. |
               '-backup-DLUS-name--+-network-ID-+-'
 
>--+----------------------------------+------------------------->
   |          .-*SAME------------.    |
   '-ACTTMR(--+-170--------------+--)-'
              '-activation-timer-'
 
>--+-----------------------------------+------------------------>
   |            .-*SAME-----------.    |
   '-RECNNTMR(--+-170-------------+--)-'
                '-reconnect-timer-'
 
>--+--------------------------+--------------------------------->
   |             .-*SAME-.    |
   '-RECONTACT(--+-*YES--+--)-'
                 '-*NO---'
 
>--+-----------------------------------------------+------------>
   |        .-*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 LINKTYPE is *LAN, valid values range 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. 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.

8. ADJLNKSTN(*ANY) is only valid if SWITCHED is *YES and LINKTYPE is *SDLC or *IDLC. Also, ADJLNKSTN must be specified if RMTCPNAME is *ANY.

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

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

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

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