HP 3000 Manuals

NRJE Shutdown [ SNA NRJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation


SNA NRJE User/Programmer Reference Manual

NRJE Shutdown 

Two ways to shut down NRJE using MPE commands exist:

 *  Stop NRJE using an NRJECONTROL STOP or NRJECONTROL HALT command from
    MPE.

 *  Issue an SNACONTROL STOP command from MPE. This shuts down the SNA
    link and NRJE.

A STOPWS issued from within NRJE has the same effect as an NRJECONTROL
STOP. A HALT issued from within NRJE has the same effect as an
NRJECONTROL HALT. NRJECONTROL HALT and NRJECONTROL STOP as well as the
STOPWS and and HALT commands are described in the SNA NRJE Node Manager's 
Guide.  SNACONTROL STOP is described in the SNA Link Services Reference 
Manual or the SNA Link/XL Node Manager's Guide.

Upon terminating communication with the host, NRJE will set NRJEJCW in
the job stream to indicate the reason for the termination.  This JCW can
be used to determine whether to attempt to restart NRJE in the job
stream.

Possible values for                  Reason 
NRJEJCW: 
---------------------------------------------------------------------------------------
             2                       NRJE STOPWS workstation command
             4                       NRJE HALT workstation command
            17                       The LU is not active on the host.
          1224                       An unbind was received.
          3000                       SNACONTROL STOP;type=Q command
          3001                       SNACONTROL STOP;type=P command
          3003                       Link failure was detected.
          3005                       Hierarchical shutdown received.

These JCW values may vary depending on the version of the SNA link
product installed on the system.

In general, all other values set upon termination are a result of a
potential error condition encountered.

Use of NRJEJCW 

The following example can be used to restart NRJE after the host system
disconnects:

     !JOB NRJE,MANAGER>SYS/password,NRJE;OUTCLASS=,1
     !RUN NRJEMON;INFO="wsid"
     !IF NRJEJCW = 1224 OR NRJEJCW = 3005 THEN
     !  CONTINUE     << Received unbind or hierarchical shutdown >>
     !   SNACONTROL START;NODE=nodename 
     !   NRJECONTROL START;WSID=wsid 
     !ENDIF
     !EOJ

The example below includes SNACONTROL commands, which are the
responsibility of the SNA node manager and are described in the SNA Link 
Services Reference Manual or the SNA Link/XL Node Manager's Guide.

In this example, the input entered by the NRJE manager is shown in shaded
text, and instructions and explanations are in italics.

     Example 
_______________________________________________________________________________
|                                                                             |
|                                   Issue a status command before the SNA node|
|                                   is started.                               |
|                                                                             |
|     :snacontrol status;node=ibmnode                                         |
|     NODE SPECIFIED NOT ACTIVE.  (SNACIERR 9)                                |
|                                   Start the SNA node.                       |
|                                                                             |
|     :snacontrol start;node=ibmnode                                          |
|     SNA TRANSPORT VERSION: A.XX.XX                                          |
|                                                                             |
|                                   Enter the NRJE subsystem.                 |
|                                                                             |
|     :nrje r20                                                               |
|     product number version number NRJE (C) HEWLETT-PACKARD CO copyright year|
|                                                                             |
|     WELCOME TO NRJE                                                         |
_______________________________________________________________________________

          Figure 2-5.  NRJE Startup and Shutdown 
_____________________________________________________________________________________
|                                                                                   |
|                                   Issue DISPLAY INFO command.                     |
|     R20>display;info                                                              |
|                                                                                   |
|     Workstation: R20                                                              |
|     GENERAL INFORMATION                                                           |
|                    State:         INACTIVE       The workstation is INACTIVE      |
|                    Jes:           JES2           even though the SNA node has     |
|                    Remote:        RMT20          been started.                    |
|                                                                                   |
|     Host command prefix char:     $                                               |
|     Allowed console commands:                                                     |
|          Formid lookup table:     NRJETABL.NRJE                                   |
|      Default print form name:     STD                                             |
|      Default punch form name:     STD                                             |
|                                                                                   |
|     WELCOME MESSAGE:                                                              |
|     WELCOME TO NRJE                                                               |
|                                   Issue STARTWS command.  A job number is returned|
|                                   identifying the file that has been streamed.    |
|                                                                                   |
|     R20>startws                                                                   |
|                                                                                   |
|     #J745                                                                         |
|                                   immediately issue another DISPLAY INFO command. |
|     R20>display;info                                                              |
|                                                                                   |
|     Workstation: R20                                                              |
|     GENERAL INFORMATION                                                           |
|                    State:         Mon Pending    The state is now Monitor         |
|                    Jes:           JES2           Pending a transient state.       |
|                    Remote:        RMT20          It will soon become ACTIVE.      |
|     Host command prefix char:     $                                               |
|     Allowed console commands:                                                     |
|          Formid lookup table:     NRJETABL.NRJE                                   |
|      Default print form name:     STD                                             |
|      Default punch form name:     STD                                             |
|                                                                                   |
|     WELCOME MESSAGE:                                                              |
|     WELCOME TO NRJE                                                               |
_____________________________________________________________________________________

          Figure 2-5.  NRJE Startup and Shutdown (cont.) 
____________________________________________________________________________
|                                                                          |
|                                   Issue another DISPLAY INFO command.    |
|                                                                          |
|     R20>display;info                                                     |
|                                                                          |
|     Workstation: R20                                                     |
|     GENERAL INFORMATION                                                  |
|                    State:         ACTIVE         The state is now ACTIVE.|
|                    Jes:           JES2                                   |
|                    Remote:        RMT20                                  |
|     Host command prefix char:     $                                      |
|     Allowed console commands:                                            |
|          Formid lookup table:     NRJETABL.NRJE                          |
|      Default print form name:     STD                                    |
|      Default punch form name:     STD                                    |
|                                                                          |
|     WELCOME MESSAGE:                                                     |
|     WELCOME TO NRJE                                                      |
|                                                                          |
|     R20>display lutable                                                  |
|                                                                          |
|     WORKSTATION LU LIST                                                  |
|     LU Name   Chain Size  LU Address   Auto Start                        |
|                                                                          |
|     LU01     *     99           1          YES                           |
|     LU02     *     99           2          YES                           |
|     LU03     *     99           3          YES                           |
|     LU04     *     99           4          YES                           |
|     LU05           99           0           NO                           |
|     LU06           99           0           NO                           |
|     LU07           99           0           NO                           |
|     LU08           99           0           NO                           |
|                                                                          |
|               *  = The LU is active.                                     |
|                                                                          |
|                                   Now jobs that have been submitted are  |
|                                   transmitted. Data sets can be received.|
|                                   Console commands can be sent.          |
|                                   Console messages can be received.      |
____________________________________________________________________________

          Figure 2-5.  NRJE Startup and Shutdown (cont.) 
__________________________________________________________________________________
|                                                                                |
|                                   Identify the status of all sessions, PU-SSCP,|
|                                   LU-SSCP, LU-LU.                              |
|                                                                                |
|     R20>:snacontrol status;node=ibmnode                                        |
|                                                                                |
|                                   SNACONTROL commands can be entered from your |
|                                   configured NRJE prompt by preceding them with|
|                                   a colon ( : ).                               |
|                                                                                |
|                                   For MPE V systems, the following displays:   |
|                                                                                |
|        PU    - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  1 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  1 - LU  1   STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  2 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  2 - LU  1   STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  3 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  3 - LU  1   STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  4 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  4 - LU  1   STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  5 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  6 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  7 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|        LU  8 - SSCP    STATE: ACTIVE         TRACE OFF   USER: MANAGER.SYS     |
|                                                                                |
|                                   For MPE XL systems, the following displays:  |
|                                                                                |
|        SESSION ID      STATE         TRACE        USER                         |
|        ----------------------------------------------------                    |
|        PU   - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 1 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 2 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 3 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 4 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 5 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 6 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 7 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
|        LU 8 - SSCP    SESS_ACTIVE     OFF      MANAGER.SYS                     |
__________________________________________________________________________________

          Figure 2-5.  NRJE Startup and Shutdown (cont.) 
________________________________________________________________________________
|                                                                              |
|                                   Stop the SNA node, and so all workstations,|
|                                   in a quiescent manner.                     |
|     R20>:snacontrol stop;node=ibmnode;type=q                                 |
|                                                                              |
|                                   Issue an SNACONTROL STATUS command after   |
|                                   the node is closed.                        |
|                                                                              |
|     R20>:snacontrol status;node=ibmnode                                      |
|     NODE SPECIFIED IS NOT ACTIVE.  (SNAERR 11)                               |
|                                                                              |
|                                   Issue another DISPLAY INFO command.        |
|                                                                              |
|     R20>display;info                                                         |
|                                                                              |
|     Workstation: R20                                                         |
|     GENERAL INFORMATION                                                      |
|                    State:         INACTIVE  Workstation is INACTIVE.         |
|                    Jes:           JES2                                       |
|                    Remote:        RMT20                                      |
|     Host command prefix char:     $                                          |
|     Allowed console commands:                                                |
|          Formid lookup table:     NRJETABL.NRJE                              |
|      Default print form name:     STD                                        |
|      Default punch form name:     STD                                        |
|                                                                              |
|     WELCOME MESSAGE:                                                         |
|     WELCOME TO NRJE                                                          |
|                                                                              |
|     R20>exit                                                                 |
________________________________________________________________________________

          Figure 2-5.  NRJE Startup and Shutdown (cont.) 



MPE/iX 5.0 Documentation