JES2 Device and Initiator Panels

Introduction

IOF provides full-screen device support for all JES2 devices and initiators. This feature is primarily designed for use by operators and may not be allowed to all users. These options may not appear on the IOF Option Menu for some users who are not authorized to use them.

Invoking the Device Options Menu

From the IOF Option Menu, the D option displays the IOF Device Options Menu. It can also be displayed by entering /D from any IOF panel. This menu is used by operators to specify exactly which device(s) they wish to control.

---------------------------IOF-Device-Options-Menu----------------------------- COMMAND ===> LPR - Local Printers PR - All Printers OFF - Offload Devices LPU - Local Punches PU - All Punches RJL - RJE Lines LRD - Local Readers PPU - All Printers/Punches NJL - NJE Lines RPR - Remote Printers RDI - Internal Readers UNL - Unallocated Lines RPU - Remote Punches RJE - Remote Work Stations LNE - All Lines RRD - Remote Readers NJE - NJE Devices ALL - All Devices INIT - Initiators Enter 1 to 16 specific device names separated by spaces. Rnn means all devices for remote nn. Example: PRT1, R23, R12.PR1, LNE5, L21.JR1, INIT10 DEVICES ==> ==> ==> Enter 1 to 16 destinations. Only devices associated with these destinations will be listed. Example: LOCAL, RALEIGH, NAPLES, R5, R23, N10 DEST ==> ==> ==>

One or more device names can be entered in the DEVICES field to specify exactly which devices are to be displayed. Classes of devices, such as printers or lines, can also be selected, as can devices associated with specific destinations. Many operators control only a limited set of devices. Specific devices can be made the default for a specific operator by entering the SAVEPROF command with the device names filled in the DEVICES field.

Now, assume that LPR is entered in the command area to display all local printers as shown in the display below.

-----------------------------IOF-Device-List-Display-----------(-2-)------------ COMMAND ===> SCROLL ===> CURSOR --------------------------- Local Printers/Punches ---------------------------- -------DEVICE-----ACT--STATUS----JOBNAME--JOBID-------SIZE-----LEFT-UNITS------ _ 1 PRINTER1 ACTIVE M13GEN J001435 12035 5479 LINES _ 2 PRINTER2 INACTIVE

This is the IOF Device List Display for local printers. It shows the status of each device, and the name and size of the active job if any. You can enter line commands in the line command area for each device. You can shift right several times to see additional information about each device in the list.

Device Detail Menus

Device detail panels let you see all attributes of a device on a single panel. Applicable commands are documented on the panel. Device attributes can be modified by authorized users by simply overtyping the applicable field directly on the panel. Of course the same commands and overtyping capabilities exist on the Device List Display shown before, but most of the attributes require shifting right one or more times to see.

To see all attributes of the device on a single screen, enter ? in its action area. This produces a detail menu for the device. Assume you entered ? in the action area for PRINTER1 on the panel above to produce the printer detail menu shown below.

-----------------------IOF-Printer/Punch-Detail-Display-1------------------------ COMMAND ===> ST - Start Z - Halt FWD n - Fwd space n DG - Display Group P - Stop I - Interrupt B n - Backspace n DQ - Display Queue RES - Restart CAN - Cancel N - Repeat DQR - Ready Queue DEVICE-----ACT--STATUS----JOBNAME--JOBID-------SIZE-----LEFT-UNITS-LASTFORM---- PRINTER1 ACTIVE M13GEN J001435 12035 2469 LINES STD FORMS ===> STD CLASS ===> A WTRID ===> BURST ===> LIM ===> 0-10000 PLIM ===> PAUSE ===> N RANGE ===> J1-9999 JOB ===> M13GEN SEPDS ===> N MODE ===> FSS ===> SEP ===> Y FLASH ===> NPRO ===> MARK ===> DEVFCB ===> SETVP ===> HALT PRESELCT ===> COPYMARK ===> TRANS ===> DEFAULT SEPCHARS ===> FCB ===> 6 UCS ===> XN MODIFY ===> PRMODE ===> LINE ROUTECDE ===> LOCAL

Device detail panels are available for all JES2 devices. The allowable commands for the device are listed at the top of the panel. Device characteristics fields are listed at the bottom of the panel. Device commands can be entered either on the Device Detail Panel or on the Device List Panel. Device characteristics can be modified by overtyping on either panel. Printers have so many characteristics that they will not all fit on one panel, so seldom used parameters are shown on an additional display that can be displayed by entering DOWN.

Operators who are responsible for a large number of devices will prefer to begin with a Device List Display and occasionally select a specific device for detailed display. Operators who are responsible for only one or two printers will probably only use the detail display.

Other Device List Examples

All JES2 devices can be displayed on the Device List Display. A display of both NJE and RJE LINES is shown below.

-----------------------------IOF-Device-List-Display-----------(-6-)------------ COMMAND ===> SCROLL ===> CURSOR ------------------------------------ Lines ------------------------------------ -------DEVICE-----ACT--STATUS----TYPE-CONNECTED-UNIT-MONITOR-TRACE-DISC-------- _ 1 LINE1 ACTIVE NJE BOSTON SNA N N _ 2 LINE2 ACTIVE RJE RMT2 SNA N N _ 3 LINE3 DRAINED SNA N N _ 4 LINE4 ACTIVE BSC N N _ 5 LINE5 ACTIVE RJE RMT23 SNA N N _ 6 LINE6 ACTIVE NJE CHICAGO SNA N N

Line Commands

As with all IOF menus, line commands can be entered in the action area to the left of specific devices. Also, the device menu number(s) followed by the command can be entered in the command area. For example, LINE3 on the sample menu above can be started by simply entering ST in it's action area or by entering 3 ST in the command area. All six lines can be drained by entering 1-6 P in the command area.

Specific device commands vary by device type and the version of JES2 being run but are fully documented on the Device Detail Panels for the different types of devices. Some of the most common device commands are:

Parameters on Device Commands in the Command Area

All of the options and parms that are available on the Device Detail Menus are also available directly on the Device List Menu. This can be very useful for invoking device commands in an IOF clist or for performing device functions from a line-mode terminal.

Data set separator
Operand Equivalent JES2 parm Description
ASIS(Y/N) A=Y/N Send extraneous ejects
AUTLgn(Y/N) A=Y/N Auto logon
AUTH(n) A=n Command authority
Burst(YES/NO) B=Y/N Burst
CHR1(table) X1=table Character table 1
X1(table) X1=table Character table 1
CHR2(table) X2=table Character table 2
X2(table) X2=table Character table 2
CHR3(table) X3=table Character table 3
X3(table) X3=table Character table 3
CHR4(table) X4=table Character table 4
X4(table) X4=table Character table 4
CKPTLINE(nn)CKPTLINE=nn Checkpoint lines
CKPTMODE(mode)CKPTMODE=mode Checkpoint mode
CKPTPAGE(nn)CKPTPAGE=nn Checkpoint pages
CKPTSEC(nn) CKPTSEC=nn Checkpoint seconds
CLass(classes)Q=classes Sysout classes
Q(classes) Q=classes Sysout classes
COMpact(table)Z=table Compaction table
COPYMARK(value)COPYMARK=value Increment copy marks
Z(table) COPYMART=value Increment copy marks
CREATOR(userid)CREATOR=userid W S Creator Userid
DEVFCB(fcb) DEVFCB=fcb Default FCB
DISC(Q/I) D=Q/I Disconnect
DISCIntv(nn)D=nnn Disc. interval
DISP(disp) DISP=disp Offload disposition
DS(select) DS=select Held data set select
DSName(dsn) DSN=dsn Offload dsname
EJECT(Y/N) EJECT=Y/N Pageeject at RJE start
FCB(fcb) C=fcb Forms control
FLAsh(flash)O=flashFlash value
FLUSH(Y/N) FLUSH=Y/N Blank card at end of DS
Forms(forms)F=forms Forms value
FSS(name) FSS=name FSS name
HELd(select)H=select Held job select
HOLd(Y/N) H=Y/N Hold status
INITClas(classes)On $TI cmd Initiator classes
IClass(classes)On $TI cmd Initiator classes
JOB(job) JOBNAME=job Job name select
JOBClass(classes)CL=classes Offload classes
LABEL(type) LABEL=type Label type
LIMit(nn) LIM=nn Record limits
MArk(Y/N) M=Y/N Mark
MForm(T/J/M)MFORM=T/J/M Message Format
MOD(mods) MOD=mods Upload modifications
MODE(mode) MODE=mode Control mode
MODIfy(copymod)Y=copymod Copymod
MONitor(Y/N)E=Y/N Monitor status
MSGclass(c) Q=class Reader msg class
NOTify(notify)NOTIFY=notify Notify option
NPRo(value) NPRO=valueNon-process runout
OFFUnit(type,n)UNIT=(type,n) Offload unit type
UNIT(type,n)UNIT=(type,n) Offload unit type
OUTDISP(disp) OUTDISP=disp Output disposition
PAUse(Y/N) P=Y/NPause option
PLIMit(nn) PLIM=nn Page limit
PRDest(dest)P=dest Reader print dest
PRESELCT(val) PRESELCT=val FSS preselect value
PRMode(mode)PRMODE=mode Process mode
PMD(mode) PRMODE=mode Process mode
PROTect(Y/N)PROTECT=Y/N Protection option
PUDest(dest)U=dest Reader punch dest
RAnge(range)RANGE=range Range
RETPD(period) RETPD=period Retention period
ROUtecde(dests)R=dests Print Punch dests
DEST(dests) R=dests Print Punch dests
SEP(value) S=value Job separators
SEPCHARS(CURRENT/ DEFAULT) SEPCHARS=CURRENT/ DEFAULTSepchars
SEPDs(value)SEPDS=value Data set separator
SETUP(value)SETUP=value Setup value
SPacing(n) K=n Spacing
CC(spacing) K=n Spacing
K(spacing) K=n Spacing
SYSAff(sysid) S=sysid System affinity
SYSRdr(sysid) S=sysid System affinity
SYSID(sysid)SYS=sysid Affinity (offload)
SYSOff(sysid) SYS=sysid Affinity (offload)
TRace(I N) TR=I N Trace status
TRANS(Y/N DEFAULT)TRANS=Y/N DEFAULT Translate chars
UCS(ucs)T=ucsUCS value
UNIT=cua/SNAUNIT=cua/SNA Hex unit addr or SNA
VOLS(nn) VOLS=nn Offload volume count
VOLUmes(vols) VOLUME=vols Spool volumes
WS(criteria)WS=criteria Work select
WTRid(writer) W=writer External writer name
XEQDest(node) X=node Reader xeq node

Primary Commands

The Device List Menu has several primary commands to manipulate the list of devices and individual devices on the list. Primary commands must be entered in the command area.

Exclude Devices from List

Exclude devices or initiators from the menu based on some display field meeting a specified condition. Exclude with no parameters resets all previous excludes.

Syntax

EXCLude fieldname operator string

fieldname. The display field name. Field names are normally the same as the field heading. See the Appendix for detailed information on using HELP to determine field names.

operator. Comparison operator. Valid operators are EQ, NE, LT, GT, CT (containing), NC (not containing), BG (beginning), and NB (not beginning).

string. The string to be compared against. If string is omitted, then a blank string is assumed. The string can be enclosed in single quotes.

Examples

        EXCLUDE STATUS NE ACTIVE
        EXCL  DEVICE BG PUN
        EXCL  SECTION NE LINE

Unexclude Devices from List

Return excluded devices to the menu based on a display field meeting a specified condition.

Syntax

UNEXcl fieldname operator string

fieldname. The display field name. Field names are normally the same as the field heading. See the Appendix for detailed information on using HELP to determine field names.

operator. Comparison operator. Valid operators are EQ, NE, LT, GT, CT (containing), NC (not containing), BG (beginning), and NB (not beginning).

string. The string to be compared against. If string is omitted, then a blank string is assumed. The string can be enclosed in single quotes.

Sort Device List

Sort the list of devices or initiators based on a display field. Devices or initiators are sorted within their original device section.

Syntax

SORT fieldname [ Desc ]

fieldname. Display field on which to sort. See the Appendix for detailed information on using HELP to determine field names.

Desc. Sort in descending order.

Examples

             SORT  FORMS
             SORT  SIZE  D

Find a Device

Find a specific device in the device list.

Syntax

FIND [ section ] [ fieldname ] string

section. A section name can be specified as the first operand to limit the search to devices or initiators in that section. Section names are documented in HELP for the panel.

fieldname. A field name can be specified to designate the search field. Device name (DEVICE) is the default field name if none is specified. See the Appendix for detailed information on using HELP to determine field names.

string. The string to be found.

Examples

           FIND  CONNECT  MIAMI
           FIND  R18.PR2

Locate

Locate the first device with a field equal to or greater than a specified value. The device list should previously be sorted on the field.

Syntax

LOCate [ section ] [ fieldname ] string

section. A section name can be specified as the first operand to limit the search to devices or initiators in that section.

fieldname. A field name can be specified to designate the locate field. Device name is the default field name if none is specified.

string. The string to be located.

Examples

           LOCATE  PRINTER9
           LOC  R23

Up and Down

Scroll the Device List Menu up or down.

Syntax

Down / Up [ nnn / Max / Section ]

nnn. Number of rows to scroll up or down.

Max. Scroll to the top or bottom of the menu.

Section. Scroll up to the previous section or down to the next section in the menu. Each device type is located in a different section.

Right and Left

Scroll the menu to the left or right.

Syntax

Right / Left [ nnn / Max ]

nnn. Number of columns to scroll right or left.

Max. Scroll to the right or left margin.

Rearranging Columns on the Panel

See Chapter 6 for a description of the CUT, PASTE, and ARRANGE commands to customize the panel display format.

Table of Contents