HP 3000 Manuals HP 3000 Manuals
Configuring SNA NRJE Once you have opened the configuration file, you are placed in the NMMGR Main screen. Main Screen From this screen you can select the category of network subsystems you want to configure.Figure 3-2. Main Screen To access the NMMGR branch for configuring SNA NRJE, press [f2] (Go To HP-IBM). This places you at the HP-IBM Configuration screen. HP-IBM Configuration Screen From this screen you can select the item you want to configure.Figure 3-3. HP-IBM Configuration Screen To select NRJE configuration press [f3] (Go To NRJE). NRJE Configuration Screen After you have selected NRJE configuration, NMMGR displays the NRJE Configuration screen. (You can go directly to this screen from any screen by typing @NRJE in the command window and pressing [ENTER].) Here you specify information about the new NRJE workstation you are configuring or the existing workstation you are modifying.Figure 3-4. NRJE Configuration Screen Example Fields Path For display only. The NMMGR branch you are in. WSID Name The name of the new workstation you are configuring, or the existing NRJE workstation whose configuration you are modifying. The name can be up to eight alphanumeric characters long; the first character must be alphabetic. New Name The new name of an existing NRJE workstation. The name can be up to eight alphanumeric characters long; the first character must be alphabetic. Once you have entered the new name, press [f4] (Rename); the workstation is then renamed. Configured NRJE For display only. The names of the NRJE workstations that have Workstation IDs been configured. You can configure a maximum of 64 workstations in a configuration file (use [f1] [Next Page] to display more fields); no more than 8 workstations can be active at one time. File For display only. The name of the configuration file. Once you have entered the name of the workstation, press [f5] (Add) if this is a new configuration, or press [f6] (Update) if you are modifying a configuration. This places you at the NRJE Configuration: Workstation Data screen. Workstation Data Screen After you have selected a workstation, NMMGR displays the NRJE Configuration: Workstation Data screen. (You can go directly to this screen from any screen by typing @NRJE.wsid in the command window and pressing [ENTER].) Here you specify the SNA node to be associated with the workstation, and data to identify the workstation to the host.Figure 3-5. NRJE Workstation Data Screen Example Fields Path For display only. The NMMGR path for this screen. It includes the name of the NRJE workstation you are configuring. SNAnode Name Required. The name of the SNA node the workstation is to use. Host Configuration: For troubleshooting purposes, we strongly recommend that this match the puname operand of the PU macro that defines this node on the host (VTAM); see table 3-1. Remote Node Required. This identifies the workstation to the host. Number Host Configuration: * JES2: This must match the RMTnnnn macro for the SNA node this workstation is to use; see table 3-4. * JES3: This must match the N parameter of the RJPWS macro, the JNAME parameter of the CONSOLE macro, and the JNAME parameter of the DEVICE macro; see table 3-6. * VSE/POWER: This must match the REMOTE parameter of the PRMT macro; see table 3-7. Line Password The password for the supported host job entry subsystem. Default: Blank (no password) Host Configuration: * JES2: This must match the PASSWORD parameter of the LINEnnn macro; see table 3-4. * JES3: This must match the P parameter of the RJPWS macro; see table 3-6. * VSE/POWER: This must match the PSWRD parameter of the PRMT macro; see table 3-7. Logmode An entry in the Logmode Table. This can be up to eight Identifier alphanumeric characters long; the first character must be alphabetic. Default: Blank (use the first entry in the Logmode Table) Host Configuration: This must match the LOGMODE parameter of the MODEENT macro in the Logmode Table entry used by this workstation (VTAM); see table 3-2. APPLID Required. The VTAM application identifier for the host job entry subsystem. If you do not know the correct identifier to enter here, ask the host system programmer. Host Configuration: * JES2: This must match the APPLID subparameter of the LOGONn global parameter; see table 3-3. * JES3: This must match the APPLID subparameter of the COMMDEFN global parameter; see table 3-5. Term Password The terminal password. You must type the case (upper case or lower case) of each character exactly as it was specified on the host. Default: Blank (no password) Host Configuration: * JES2: This must match the PASSWORD parameter of the RMTnnnn macro; see table 3-4. * JES3: Do not specify. * VSE/POWER: Do not specify. Workstation Required. The prompt for terminal users of this workstation. Prompt Leading or imbedded blanks are not removed. Default: The greater-than sign (>) Console Mode The prompt for the owner of the workstation console. Prompt Default: Blank (no prompt) Job Entry Required. The subsystem the host is running. Enter JES2, JES3, Subsystem or VSE/POWER. Host Command Required. The character preceding all host console commands. Prefix Char Host Configuration: * JES2 and JES3: The command prefix can be configured; this parameter must match the prefix specified in the host job entry subsystem configuration. * VSE/POWER: The value entered here is used interactively only. VSE/POWER commands must be entered using this prefix. Any non-interactive VSE/POWER command must still be preceded by * Å. .Å (Å represents a blank). Allowed Host The host commands users without NM capabilities are allowed to Commands include in jobs submitted to the host. Multiple commands can be specified by separating them with semicolons (;). NRJE will compare the value (up to the first blank character) in this field with the command entered. If the characters match, the command is transmitted to the host. Default: All blanks Examples: Allowed Host Commands Explanation $D Allows all JES2 commands that start with "$D". $D; $C; $L Allows all JES2 commands that start with "$D", "$C", or "$L". $ Allows all JES2 commands. *I Allows all JES3 commands that start with "*I". all blanks No commands are allowed. Auto Recovery Required. Enter Y if you want NRJE to try to recover if SNA Transport reports a link error; NRJE will keep trying to recover until it is successful. Default: Y Job Management Required. Enter Y to cause the output routing options (PRINT, PUNCH, and FORMS) of the SUBMIT command to be supported; N, otherwise. Default: Y Logical Unit Required. The maximum size of the RUs, in bytes, that NRJE can RU Size send to the host. Values: 256, 512, and 768 (integer) Default: 256 Host Configuration: This must match the RUSIZES parameter of the MODEENT macro in the Logmode Table entry used by the workstation; see table 3-2. Note that in the MODEENT definition the RU sizes are specified in hexadecimal (for example, X'85' for 256). * JES2: This must match the BUFSIZE parameter in the RMTnnnn macro; see table 3-4. Note that the BUFSIZE parameter overrides the RUSIZES parameter mentioned above. * JES3: This must match the BUFSIZE subparameter of the BUFFER global parameter; see table 3-5. Note that the BUFSIZE subparameter overrides the RUSIZES parameter mentioned above. * VSE/POWER: 256 is the only valid value. File For display only. The name of the configuration file. Once you have entered all of the necessary information on this screen, press [f6] (Update Data). After the information has been processed, press [f4] (Go To PAGE2) to specify more information. Workstation Data Page 2 Screen This screen is a continuation of the NRJE Configuration: Workstation Data screen. Select this screen by pressing [f4] (Go To PAGE2) on the Workstation Data screen. (You can go directly to this screen from any screen by typing @NRJE.wsid.PAGE2 in the command window and pressing [ENTER].) Here you specify more information about the workstation.Figure 3-6. Workstation Data Page 2 Screen Example Fields Path For display only. The NMMGR path for this screen. It includes the name of the NRJE workstation you are configuring. Console Scan The name of a user-defined procedure which scans the host Procedure console for an "on reader" message. For further information about creating your own procedure, see the SNA NRJE User/Programmer Reference Manual. If no procedure name is specified, NRJE uses an internal parsing algorithm to decode the messages. Formid Lookup The file (filename.group) used to route forms output. This file Table File is created by the user, and it must be in the SYS account; the filename and group are determined by the user. See the SNA NRJE User/Programmer Reference Manual for more information. Note that a sample Formid Lookup Table file is provided in the SAMPTABL file in NRJE.SYS. Default: NRJETABL.NRJE Punch Banner Required. The code the punch banner is in. Enter H for Code Hollerith, or E for EBCDIC. Default: H Punch Banner Job Required. The location in which the host job number begins in a Number Location punch banner. Range: 0 - 76 (integer) Default: 0 (the beginning of the banner) Joblog Data File Required. The data file (in NRJE.SYS) containing information about each job submitted. This file is created by SNA NRJE and given the name specified here when the workstation is activated for the first time; after that, the file is appended to. This file name must be unique for each workstation. Joblog Key File Required. The key file (in NRJE.SYS) used to access the Joblog Data File. This file is created by SNA NRJE and given the name specified here when the workstation is activated for the first time; after that, the file is appended to. This file name must be unique for each workstation. Host Standard The default print form name for the workstation. This must Print Form Name match the name of the form in the Peripheral Data Information Record (PDIR) for output routed to the standard form on a print device. To determine this, see the SNA NRJE User/Programmer Reference Manual. Default: STD Host Configuration: * JES2: This must match the &STDFORM global parameter; see table 3-3. Note that if you are using JES2 version 1.3.6 (or later) or 2.1.5 (or later), the &STDFORM parameter is different; use the migration tables to determine the correct &STDFORM. If &STDFORM is not specified, enter STD here. * JES3: This must match the FORMS subparameter of the OUTSERV global parameter; see table 3-5. If FORMS is not specified, enter 1PRT here. * VSE/POWER: Enter all blanks. Host Standard The default punch form name for the workstation. This must Punch Form Name match the name of the form in the Peripheral Data Information Record (PDIR) for output routed to the standard form on a punch device. To determine this, see the SNA NRJE User/Programmer Reference Manual. Default: STD Host Configuration: * JES2: This must match the &STDFORM global parameter; see table 3-3. Note that if you are using JES2 version 1.3.6 (or later) or 2.1.5 (or later), the &STDFORM parameter is different; use the migration tables to determine the correct &STDFORM. If &STDFORM is not specified, enter STD here. * JES3: This must match the CDSTOCK subparameter of the OUTSERV global parameter; see table 3-5. If CDSTOCK is not specified, enter 5081 here. * VSE/POWER: Enter all blanks. File For display only. The name of the configuration file. Once you have entered all of the necessary information on this screen, press [f6] (Update Data). After the information is processed, press [f8] (Prior Screen) to redisplay the NRJE Configuration: Workstation Data screen. Then, if you need to configure LUs for the workstation, press [f1] (Go To LU). Otherwise, press [f8] (Prior Screen) until you get to the NMMGR menu screen or select screen you need next. LU Data Screen Once you have specified all of the workstation data, you are ready to configure the LUs for the workstation. You do this on the NRJE Configuration: LU Data screen. Select this screen by pressing [f1] (Go To LU) on the NRJE Configuration: Workstation Data screen. (You can go directly to this screen from any screen by typing @NRJE.wsid.LU in the command window and pressing [ENTER].) The LUs implement the logical readers and the logical writers. Note that the LUs are pooled: A given LU can implement any of the logical readers or writers.Figure 3-7. LU Data Screen Example Fields Path For display only. The NMMGR path for this screen. It includes the name of the workstation whose LUs you are configuring. Configured The names of the LUs you want to configure for the workstation. NRJE LUs (Under You can configure a maximum of 16 LUs for a workstation. Workstation) LU Name For NRJE/V, this is the name of an SNA node class configured on the MPE V SNA Configuration: Classes screen. For NRJE/XL, this is the LU Name (not the NAU number) of an LU as it is configured on the MPE XL SNANode Configuration: PU and LU Data screen. The name can be up to eight alphanumeric characters long; the first character must be alphabetic. Autostart Enter Y if you want the LU to be automatically initialized when the workstation is started up; N, otherwise. You can override this at workstation startup time. Note that you cannot enter a value in this field if a value is not also entered in the corresponding LU Name field. Default: N File For display only. The name of the configuration file. Once you have entered the data for all of the LUs, press [f6] (Update Data). After the information is processed, press [f8] (Prior Screen) until you get back to the NRJE Configuration: Workstation Data screen. Then, if you need to configure the virtual reader for the workstation, press [f2] (Go To READER). Reader Data Screen Once you have configured the LUs for the workstation, you should configure the workstation's virtual reader next. You do this on the NRJE Configuration: Reader Data screen. Select this screen by pressing [f2] (Go To READER) on the NRJE Configuration: Workstation Data screen. (You can go directly to this screen from any screen by typing @NRJE.wsid.READER in the command window and pressing [ENTER].) NRJE spools submitted jobs to the virtual reader. If the communications line to the host is down, NRJE holds jobs in the queue until the line is active. NRJE then transmits the jobs according to their position in the queue. You configure only one reader for each workstation. This reader is an internal MPE spooling device and does not correspond to readers configured at the host.Figure 3-8. Reader Data Screen Example Fields Path For display only. The NMMGR path for this screen. It includes the name of the workstation whose virtual reader you are configuring. Logical Device Required. The ldev to which NRJE will spool submitted jobs. For NRJE/V, you must configure this ldev into the I/O system by using the SYSDUMP utility (see the SNA Link Services Reference Manual); this must be followed by a cold start. For NRJE/XL, you must configure an ldev using the SYSGEN utility and then reboot the system. See the System Startup, Configuration, and Shutdown Reference Manual (32650-6005). This ldev must not be used for anything else. When the system is rebooted, NRJE/XL will complete the configuration process for you.
NOTE Do not specify the same reader ldev for workstations that might be simultaneously active.
Range: 1 - 999 (integer) SYSDUMP (MPE V only): Configure the ldev as a type 22 subtype 2 device. The DRT must be back-referenced to the ldev number of the INP or the system disc. Set the record width to 40 words; set the unit, channel, and output device to 0. Specify driver IONRDR0. Chain Size Required. The maximum number of RUs that NRJE will transmit before requiring a definite response from the host. You can get higher throughput with larger values, but if line trouble occurs, the data might have to be retransmitted from the beginning of the chain. Also, if you are using only a few LUs, specifying a larger value here might impact remote console response time. Range: 1 - 99 (integer) Default: 10 Translation Required. The type of translation NRJE will perform on jobs Indicator sent to the host: * 0 = Native - 3000 translation Input in the Native-3000 language (ASCII) is translated to EBCDIC before it is sent to the host. * 1 - 255 = Native Language ID An integer that corresponds to a language other than Native-3000. Input in the language chosen is translated to EBCDIC before it is sent to the host. For more information on Native Language support, see the Native Language, Message Catalogs, and User Logging manual (32650- 60012). Default: 0 Number of Required. The number of logical host readers that the NRJE Readers remote workstation will use. (Also see the LU Data screen description earlier in this chapter.) Range: 1 - 7 Default (JES2 and JES3): 1 Host Configuration: * JES2: This must be less than or equal to the NUMRD parameter of the RMTnnnn macro; see table 3-4. * JES3: This must be less than or equal to the RD parameter of the RJPWS macro; see table 3-6. * VSE/POWER: This field is ignored (because one reader is assumed). Compression On Required. Enter Y if the host accepts compressed in-bound data; N, otherwise. Default: Y Host Configuration: This must match the PRIPROT parameter of the MODEENT macro in the Logmode Table entry used by this workstation (VTAM); see table 3-2. * JES2: If you specify Y, the COMP parameter must be specified in the RMTnnnn macro for the workstation; see table 3-4. * JES3: Does not apply. * VSE/POWER: You must specify N, because VSE/POWER does not support compressed in-bound data. File For display only. The name of the configuration file. Once you have configured the readers for the workstation, press [f6] (Update Data). After the information is processed, press [f8] (Prior Screen) until you get back to the NRJE Configuration: Workstation Data screen. Then, if you need to configure the virtual writers for the workstation, press [f3] (Go To WRITER). Otherwise, press [f8] (Prior Screen) until you get to the NMMGR menu screen or select screen you need next. Writer List Screen Once you have configured the workstation's virtual reader, you should configure the virtual writers. You do this on the NRJE Configuration: Writer List screen. Select this screen by pressing [f3] (Go To WRITER) on the NRJE Configuration: Workstation Data screen. (You can go directly to this screen from any screen by typing @NRJE.wsid.WRITER in the command window and pressing [ENTER].) You must configure an NRJE writer for each printer or punch defined at the host. The writers are spooled devices; they act as logical printers and punches and receive output data sets from the host. You must configure at least one writer per workstation.Figure 3-9. Writer List Screen Example Fields Path For display only. The NMMGR path for this screen. It includes the name of the workstation whose virtual writers you are configuring. Writer Name The name of the new writer you are configuring, or the existing writer whose configuration you are modifying. The name must be in one of these formats: * PRx = a logical printer, where x is an integer from 1 through 7. * PUx = a logical punch, where x is an integer from 1 through 7. Host Configuration: * JES2: This must match the PRm or PUm portion, respectively, of the Rnnnn.PRm or Rnnnn.PUm macro; see table 3-4. * JES3: This must match the number of the device (PRm or PUm) in the JNAME parameter of the DEVICE macro; see table 3-6. * VSE/POWER: Specify PR1 and PU1. New Name The new name of an existing writer. The name must be in one of these formats: * PRx = a logical printer, where x is an integer from 1 through 7. * PUx = a logical punch, where x is an integer from 1 through 7. Host Configuration: * JES2: This must match the PRm or PUm portion, respectively, of the Rnnnn.PRm or Rnnnn.PUm macro; see table 3-4. * JES3: This must match the number of the device (PRm or PUm) in the JNAME parameter of the DEVICE macro; see table 3-6. * VSE/POWER: Specify PR1 and PU1. Once you have entered the new name, press [f4] (Rename); the writer is then renamed. Configured NRJE For display only. The names of the logical writers that have Writers (Under been configured for the workstation. You can configure a Workstation) maximum of 14 writers for a workstation (seven readers and seven writers). Note that the total number of configured writers must match the number of writers configured in the host job entry subsystem. File For display only. The name of the configuration file. Once you have entered the name of the writer, press [f5] (Add) if this is a new configuration, or press [f6] (Update) if you are modifying a configuration. This places you at the NRJE Configuration: Writer Data screen. Writer Data Screen After you have selected a writer, NMMGR displays the NRJE Configuration: Writer Data screen. (You can go directly to this screen from any screen by typing @NRJE.wsid.WRITER.writername in the command window and pressing [ENTER].) Here you enter information about the logical writer you are configuring.Figure 3-10. Writer Data Screen Example Fields Path For display only. The NMMGR path for this screen. It includes the names of the workstation and the writer you are configuring. Output Required. The default destination for output received on the Destination writer. Enter an MPE device class specification (eight alphanumeric characters or less), an ldev number of a spooled device, or a formid (in single quotes). Use the formid to specify a Lookup Table entry that defines the default output device characteristics. Forced Required. Enter Y if the formid specified in the Output Destination field is to be used for all job output (standard form and non-standard form) from this writer. Note that you can enter Y only if you have specified a formid in Output Destination. Enter N if all output management routing requests (special forms designations in the host JCL) received on the writer are to be honored. This field does not affect job management output routing requests (that is, routing designations given as part of the SUBMIT command). Default: N Output Priority Required. The priority for output from this writer. Range: 1 - 14 (integer) Default: 8 Translation Required. The type of translation NRJE will perform on data Indicator sets received from the host: * -1 = No translation SNA NRJE will write whatever it receives from the host without translation. * 0 = Native-3000 Translation SNA NRJE will use the Native-3000 translation table to translate data received from the host. You also must have specified 0 for the Translation Indicator field on the NRJE Configuration: Reader Data screen. * 1 - 255 = Native Language ID An integer that corresponds to a language other than Native-3000. SNA NRJE will use the translation table for the designated native language to translate data received from the host. You also must have specified the same value for the Translation Indicator field on the NRJE Configuration: Reader Data screen. For more information on Native Language support, see the Native Language, Message Catalogs, and User Logging manual (32650-60012). Default: 0 Writer Exit The name of a user-defined procedure that will decode the host Procedure banner (separator page) and inform SNA NRJE of the host job number of returning data sets. For more information about creating your own procedure, see the SNA NRJE User/Programmer Reference Manual. If no procedure name is specified, NRJE uses an internal parsing algorithm to decode the banner. Default: Blank (no procedure name) File For display only. The name of the configuration file. Once you have entered the writer information, press [f6] (Update Data). After the information is processed, press [f8] (Prior Screen) until you get to the NMMGR menu screen or select screen you need next.
![[]](../../pic3k/M010429/F03023c50.gif)
![[]](../../pic3k/M010429/F03033c50.gif)
![[]](../../pic3k/M010429/F03043c50.gif)
![[]](../../pic3k/M010429/F03053c50.gif)
![[]](../../pic3k/M010429/F03063c50.gif)
![[]](../../pic3k/M010429/F03073c50.gif)
![[]](../../pic3k/M010429/F03083c50.gif)
![[]](../../pic3k/M010429/F03093c50.gif)
![[]](../../pic3k/M010429/F03103c50.gif)