 |
» |
|
|
|
Once you have opened the configuration file, you are placed
in the NMMGR Main screen. Main Screen | |
From the Main Screen you can select the category of network subsystems
you want to configure, as shown in Figure 3-1 “Main Screen”. To access the NMMGR branch for configuring SNA NRJE, press [f4] (Go To HP-IBM). This places you at the HP-IBM Configuration screen. HP-IBM Configuration Screen | |
From the HP-IBM Configuration Screen you can select the item
you want to configure, see Figure 3-2 “HP-IBM Configuration Screen”. Figure 3-2 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, as shown in Figure 3-3 “NRJE Configuration Screen Example”.
(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-3 NRJE Configuration Screen Example - 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 Workstation IDs
For display only. The names
of the NRJE workstations that have 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] [Modify] 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, as shown in Figure 3-4 “NRJE Workstation Data Screen Example”. (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-4 NRJE Workstation Data Screen Example - 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 “AFC/NCP and ACF/VTAM Macro Corresponding
Values”. - Remote Node Number
Required. This identifies
the workstation to the host. Host Configuration: - Line Password
The password for the supported host job entry subsystem. Default: Blank (no password) Host Configuration: - Logmode Identifier
An entry in the Logmode Table. This can be up to
eight 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 “AFC/NCP and ACF/VTAM Logmode Table”. - 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: - 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: VSE/POWER: Do not specify.
- Workstation Prompt
Required. The prompt for
terminal users of this workstation. Leading or imbedded blanks are
not removed. Default: The greater-than sign
(>) - Console Mode Prompt
The prompt for the owner of the workstation console. Default: Blank (no prompt) - Job Entry Subsystem
Required. The subsystem the
host is running. Enter JES2, JES3, or POWER (for VSE/POWER). - Host Command Prefix Char
Required. The character preceding
all host console commands. 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 *D . . D (D represents a blank).
- Allowed Host Commands
The host commands users without NM capabilities
are allowed to 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 RU Size
Required. The maximum size
of the RUs, in bytes, that NRJE can 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 “AFC/NCP and ACF/VTAM Logmode Table”. Note that in the MODEENT definition the RU sizes are specified in hexadecimal
(for example, X'85' for 256).
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] [Save 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, as shown in Figure 3-5 “Workstation Data Page 2 Screen Example”. 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-5 Workstation Data Page 2 Screen Example - Path
For display only. The NMMGR
path for this screen. It includes the name of the NRJE workstation
you are configuring. - Console Scan Procedure
The name of a user-defined procedure which scans
the host 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 Table File
The file (filename.group) used to route forms output. This 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 Code
Required. The code the punch
banner is in. Enter H for Hollerith, or E for EBCDIC. Default: H - Punch Banner Job Number Location
Required. The location in
which the host job number begins in a 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 Print Form Name
The default print form name for the workstation.
This must 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 “JES2 Global Parameter Corresponding Values”.
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. VSE/POWER: Enter all blanks.
- Host Standard Punch Form Name
The default punch form name for the workstation.
This must 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 “JES2 Global Parameter Corresponding Values”.
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. 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] [Save 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, as shown in Figure 3-6 “LU Data Screen Example”. 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-6 LU Data Screen Example - Path
For display only. The NMMGR
path for this screen. It includes the name of the workstation whose
LUs you are configuring. - Configured NRJE LUs (Under Workstation)
The names of the LUs you want to configure for the workstation.
You can configure a maximum of 16 LUs for a 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] [Save 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-7 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. This ldev must not be used for anything else. When
the system is rebooted, NRJE/XL will complete the configuration
process for you. The ldev number for the NRJE reader should be above 900
to avoid conflicts. Ldevs below 900 may be used by other devices
including virtual terminals. Do not specify the same reader ldev
for workstations that might be simultaneously active. 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 disk. 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 Indicator
Required. The type of translation
NRJE will perform on jobs 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 8-bit languages other than
Native-3000. Input in the language chosen is translated
to EBCDIC before it is sent to the host. Invalid values are: 201 Simplified Chinese
211 Traditional Chinese
221 Japanese
231 Korean For more information on Native Language Support, see the Native
Language, Message Catalogs, and User
Logging manual. Default: 0
- Number of Readers
Required. The number of logical
host readers that the NRJE 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: 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 “AFC/NCP and ACF/VTAM Logmode Table”.
JES2: If you specify Y, the COMP parameter must be specified in the RMTnnnn macro for the workstation; see Table 3-4 “JES2 Macro Corresponding Values”.
Starting with version 3 (or later) of JES2, use COMPRESS=YES instead of COMP. 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] [Save 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, as shown in Figure 3-8 “Writer List Screen Example”. 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-8 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: 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: VSE/POWER: Specify PR1 and PU1.
Once you have entered the new name, press [f4] [Rename]; the writer is then renamed. - Configured NRJE Writers (Under Workstation)
For display only. The names
of the logical writers that have been configured for the workstation.
You can configure a 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] (Modify) 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, as shown in Figure 3-9 “Writer Data Screen Example”. (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-9 Writer Data Screen Example - Path
For display only. The NMMGR
path for this screen. It includes the names of the workstation and
the writer you are configuring. - Output Destination
Required. The default destination
for output received on the 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 Indicator
Required. The type of translation
NRJE will perform on data 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 8-bit languages 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. Invalid values are: 201 Simplified Chinese
211 Traditional Chinese
221 Japanese
231 Korean For more information on Native Language support, see the Native
Language, Message Catalogs, and User
Logging manual. Default: 0
- Writer Exit Procedure
The name of a user-defined procedure that will decode the
host 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] [Save Data]. After the information is processed, press [f8] [Prior Screen] until you get to the NMMGR menu screen or select screen
you need next.
|
