\date=28 June 1989
\folio=station operator commands
\title=Station Operator Utility ERS
\headb
\autosec
\tablcon
\seth~
\block
\ 1 Batch Station Operator Commands
\ 2 Introduction
The NOS/VE batch i/o facilities are provided by CDCNET batch
i/o stations.  A CDCNET batch i/o station can be a public
station or can be a private station.  Files to be printed at a
private station carry a station operator's identity as an
attribute and can only be printed at a private station being
operated by that operator.
Jobs input from a private station carry the station operator's
user identity as an attribute (the control user attribute) and can be
statused and controlled by that user. The output of jobs
that are input from a batch station (public or private) is printed
at that same station by default.
Files to be printed at a public
station can be printed regardless of which operator (if any) is
operating the station.  Public stations can operate either with
or without an operator.  Private stations require an operator.
Station operation is done via the NOS/VE batch station operator
utility, operate_station.  Users can status but not control a station
with a subset utility, display_station.

This document describes NOS/VE batch station operator
utility commands.

This utility is not used to control NOS batch stations.

\ 2 References
\+item,n
 . Operate_Station Enhancements DAP (A8722)

 . NOS/VE Batch Support Phase II DAP (ARH7301)

 . Stand Alone Printer Support DAP (S5134)

 . Batch Device Support on NVE DAP (ARH6250)

 . NOS/VE Batch Device Support Design Direction

 . Status and Control Facility/DI ERS
\-
\ 2 Operate Station command
The purpose of this command is to invoke a copy of the Batch
Station Operator utility and to establish the requestor as the
operator of a batch station.

The requestor must be validated to operate the specified station
and the station must not already be under the control of an
operator.  For certain stations the requestor must also be using
a designated terminal.

\table;5,10,12,14,16
 ;operate_station, opes (
 ;;station_name, sn: name = $required
 ;;status)

\+flowtab;6,11

 ;station_name:  This parameter specifies the name of the
station to be operated.  In the case of a dynamic private
station (which does not have a known station name) the batch
station control facility name is used as the station name.

 ;status: See ERROR HANDLING.

\-

The user must be validated to operate the named station.

Note: For the 1.2.1 and 1.2.2 releases a user may be validated
to operate all stations or no stations, but not a particular
(list of) station(s).

\ 2 Display Station command

The purpose of this command is to invoke a restricted form of the Batch
Station Operator utility which does not establish the requestor as the
operator of a batch station.  Only the station status subcommands described
in section 1.9 are available.  These subcommands are:

\table;5,10,12,14,16
 ;display_batch_device_status
 ;display_station_queue_entry
 ;display_station_queue_status
 ;display_station_status
 ;quit

Some of the displays produced by the status subcommands are restricted to
only show data that applies to the user.  Multiple invocations of
display_station can be active on the same station at one time.  A site can
choose to restrict access to display_station.  Otherwise any NOS/VE user
can access it.

\table;5,10,12,14,16
 ;display_station, opes (
 ;;station_name, sn: name = $required
 ;;status)
\+flowtab;6,11

 ;station_name:  This parameter specifies the name of the
station to be statused.  In the case of a dynamic private
station (which does not have a known station name) the batch
station control facility name is used as the station name.

 ;status: See ERROR HANDLING.

\-
If a site defines a validation capability called scheduling_displays, the user
must be validated to status the named station.

\ 2 Quit Subcommand
The purpose of this subcommand is to relinquish operational
control of a batch i/o station and to terminate the current
instance of execution of the i/o station operator utility.

 ;quit, qui (
 ;;status)

\+flowtab;6,11

 ;status: See ERROR HANDLING.
\-
\ 2 Device Control Subcommands
\ 3 Change Batch Device Attributes
The purpose of this subcommand is to change the attributes of
a batch station device.

If an optional attribute parameter is omitted, that attribute of
the device remains unchanged.

Most of these attributes only have relevance for output devices.
Only external_characteristics_1, file_acknowledgement,
and terminal_model are meaningful for an input device.

 ;change_batch_device_attributes, chabda (
 ;;device_name, dn: name = $required
 ;;banner_highlight_field, bhf: key
 ;;;;comment_banner, cb
 ;;;;routing_banner, rb
 ;;;;site_banner, sb
 ;;;;user_file_name, ufn
 ;;;;user_name, un
 ;;;keyend
 ;;banner_page_count, bpc: integer 0..3
 ;;carriage_control_support, ccs: key
 ;;;;pre_print
 ;;;;post_print
 ;;;;(both, b)
 ;;;keyend
 ;;code_set, cs: key
 ;;;;ascii
 ;;;;ascii48
 ;;;;ascii64
 ;;;;ascii95
 ;;;;ascii128
 ;;;keyend
 ;;device_alias_1, da1: any of
 ;;;;name
 ;;;;key
 ;;;;;none
 ;;;;keyend
 ;;;anyend = $optional
 ;;device_alias_2, da2: any of
 ;;;;name
 ;;;;key
 ;;;;;none
 ;;;;keyend
 ;;;anyend = $optional
 ;;device_alias_3, da3: any of
 ;;;;name
 ;;;;key
 ;;;;;none
 ;;;;keyend
 ;;;anyend = $optional
 ;;external_characteristics_1, ec1: string 0..6
 ;;external_characteristics_2, ec2: string 0..6
 ;;external_characteristics_3, ec3: string 0..6
 ;;external_characteristics_4, ec4: string 0..6
 ;;file_acknowledgement, fa: boolean
 ;;forms_code_1, fc1: string 0..6
 ;;forms_code_2, fc2: string 0..6
 ;;forms_code_3, fc3: string 0..6
 ;;forms_code_4, fc4: string 0..6
 ;;forms_size, fs: string 1..4
 ;;maximum_file_size, mfs: integer 0..99999999
 ;;page_width, pw: integer 10..255
 ;;terminal_model, tm: name 1..25 = $optional
 ;;transmission_block_size, tbs: integer 0..65535
 ;;un_defined_fe_action, udfa: key
 ;;;;print_after_spacing, pas
 ;;;;print_before_spacing, pbs
 ;;;;discard_print_line, dpl
 ;;;keyend
 ;;un_supported_fe_action, usfa: key
 ;;;;print_after_spacing, pas
 ;;;;print_before_spacing, pbs
 ;;;;discard_print_line, dpl
 ;;;keyend
 ;;vertical_print_density, vpd: key
 ;;;;six_only
 ;;;;eight_only
 ;;;;six_any
 ;;;;eight_any
 ;;;keyend
 ;;vfu_load_procedure, vlp: name
 ;;status)

\+flowtab;6,11

 ;device_name: This parameter specifies the device
whose attributes are to be changed.

 ;banner_highlight_field:  This parameter specifies which of the
banner fields will be given prominence on this device.

 ;banner_page_count:  This parameter specifies the number of
copies of banner page that this device will include with the
file.

 ;carriage_control_support: This parameter specifies the types of
carriage control action that the device supports.

Pre_print indicates vertical positioning  prior to printing the
line.  Post_print indicates vertical positioning after printing
the line.

 ;code_set:  This parameter specifies how the
station software should fold (translate) characters before
sending them to the printer. ASCII and ASCII128 are synonymous
and indicate no folding. ASCII95 indicates that any characters
outside of the 95 character set are to be folded into characters
within the set. Likewise, ASCII64 and ASCII48 indicate
that any characters outside of the 64 or 48 character sets are
to be folded to characters within the indicated character set.
The exact translation to be performed in these cases is defined
in the CDCNET Terminal Support ERS.

 ;device_alias_n:  These parameters specify alternate names
by which the device can be referenced.  The same device alias
name can be assigned to more than one device within a station.
To cancel a previously established alias, use the keyword
'none'.

;external_characteristics_n:  These parameters specify
external_device_characteristic strings for which this device
provides support.

For output devices, these device attributes affect the
selection of files that will be printed on the device.  The
external characteristics attribute of a file must match one of
the external characteristics of the device in order for the file
to be printed on the device.

For card reader input devices, only external_characteristics_1
has meaning. External_characteristics_2, external_characteristics_3,
and external_characteristics_4 are ignored. External_characteristics_1
specifies the default code set of the card reader. String values
026 and 029 are defined.

When a NOS/VE job that generates a print file does not
specify an external device characteristics value (the usual
case) a value of 'NORMAL' is supplied for the file. Thus it is
expected that most files will need a printer with 'NORMAL'
as one of its values in order to be printed.

To cancel a previously established string, change it to spaces.

 ;file_acknowledgement:  This parameter specifies
whether or not file acknowledgement messages related to the
device are to be displayed on the station operator console.

The File Acknowledgement messages are purely informational
and do not cause suspension of a device.  They can be
selected or suppressed for the entire station via the station
definition commands.  If they are selected for the entire
station they cannot be suppressed for individual devices.  If
not selected for the station, they can be selectively activated
for a particular device via this subcommand.

If file acknowledgement is selected for an input device, a
message is sent to the operator at the completion of every job
transfer from that device. If file acknowledgement is
selected for an output device, a message is sent to the operator
at the beginning and end of every file transfer to that device.

 ;forms_code_n:  These parameters specify forms_code strings
for which this device provides support.

These device attributes affect the selection of files that
will be printed on the device.  The forms code attribute of the
file must match one of the forms codes of the device in order to
be printed on the device.

When a NOS/VE job that generates a print file does not
specify a forms code value (the usual case) a value of 'NORMAL' is
supplied for the file.  Thus it is expected that most files will
need a printer with 'NORMAL' as one of its values in order to be
printed.

To cancel a previously established string, change it to spaces.

 ;forms_size:  This parameter specifies the length in inches
of the form being used in the printer.  Strings representing
decimal numbers that are multiples of half inches from 0.5 to
31.0 are allowed.

This device attribute affects the selection of files that
will be printed on the device.

If the file's vertical print density is specified as six or
eight lines per inch, the file's page length attribute divided
by its vertical print density attribute must be less than or
equal to the forms size attribute of the device.

If the file's vertical print density is specified as 'any'
and the device's vertical print density is six_only or six_any,
then the file's page length divided by six must be less than or
equal to the forms size attribute of the device.  Similarily, if
the device's vertical print density is eight_only or eight_any,
then the file's page length divided by eight must be less than
or equal to the forms size attribute of the device.

 ;maximum_file_size:  This parameter specifies the maximum
size in bytes of output files that will be routed to this
device.

This device attribute affects the selection of files that
will be printed on the device. The byte length of
the file must be less than or equal to the maximum file size
attribute of the device in order for the file to be printed
on the device.

A value of zero indicates an unlimited file size.

 ;page_width: This parameter specifies the number of columns that
are construed to constitute a line for this device.

For printer devices,
this device attribute affects the selection of files that
will be printed on the device. The page width attribute of
the file must be less than or equal to the page width
attribute of the device in order for the file to be printed
on the device.

 ;terminal_model: This parameter specifies the model name of the
device.

 ;transmission_block_size: This parameter specifies the block size
(in bytes) to be used in transfering data for the device.

 ;un_defined_fe_action: This parameter specifies the action that
is to be taken with format effectors that are not defined. PAS
indicates print after spacing, PBS indicates print before spacing,
and DPL indicates discard print line.

 ;un_supported_fe_action: This parameter specifies the action that
is to be taken with format effectors that are defined but are not
supported by the device. PAS
indicates print after spacing, PBS indicates print before spacing,
and DPL indicates discard print line.

 ;vertical_print_density:  This parameter specifies the
vertical print density characteristics of a printer.  Six_only
indicates that the device can only print at six lines per inch.
Eight_only indicates that the device can only print at eight
lines per inch.  Six_any indicates that the device can print at
either six or eight lines per inch and will default to six if
the file being printed specifies a vertical print density value
of "any".  Eight_any indicates that the device can print at
either six or eight lines per inch and that it will default to
eight lines per inch if the file being printed specifies
a vertical print density value of "any".

This device attribute affects the selection of files that
will be printed on the device.

Files that specify six lines per inch will be printed on a
printer that specifies six_only, six_any, or eight_any.

Files that specify eight lines per inch will be printed on a
printer that specifies eight_only, six_any, or eight_any.

Files that specify a vertical print density value of "any"
will be printed on a printer that specifies six_only,
eight_only, six_any, or eight_any.

 ;vfu load_procedure:  This parameter specifies the name
of a vfu load procedure
that defines the default VFU Load
Image (VLI). This default VLI will
be loaded into the device if the file
being printed does not specify a vfu load procedure
defining a VLI that is to be loaded.

This attribute can not be changed by a station operator unless
the device was defined with a VFU_load_option value of OPER or
USER.

If a default VLI is never established for a device, the CDCNET
standard VLI will be used as the default VLI. The CDCNET standard
VLI is defined in a vfu load procedure named CDC_VFU.

 ;status: See ERROR HANDLING.

\-
\ 2 File Transfer Subcommands
\ 3 Position File
The purpose of this subcommand is to reposition an output
file with respect to an output device.

 ;position_file, posf (
 ;;device_name, dn: name = $required
 ;;location, l: any of
 ;;;;integer 0..65535
 ;;;;list 1..2 of string 1..255
 ;;;anyend = 1
 ;;units, u: key
 ;;;;(lines, line, l)
 ;;;;(pages, page, p)
 ;;;keyend = page
 ;;direction, d: key
 ;;;;(forward, f)
 ;;;;(backward, back, b)
 ;;;keyend = backward
 ;;starting_position, sp: key
 ;;;;(beginning,b)
 ;;;;(end,e)
 ;;;;(last_line_printed, llp)
 ;;;keyend = last_line_printed
 ;;preview, pv, p: integer 1..10 = $optional
 ;;status)
\+flowtab;6,11

 ;device_name: This parameter specifies a name of the device
which is to be positioned. The device must be an output device.

 ;location: This parameter specifies where the file is to be positioned.

Use of an integer indicates the number of lines or pages to
be moved forward or backward from the starting point (see
direction, units, and starting position parameters).

Use of a list of strings indicates positioning to a line containing
the desired string(s). A single string indicates positioning to a line
containing that string. Two strings indicates positioning to
a line containing the first string followed somewhere in the same line
with the second string. The starting point, units, and direction of search
parameters all affect the final location.

 ;units: This parameter specifies whether the location integer indicates
lines or pages.

The pages option also implies positioning to the
beginning of a page.  Thus, use of a location string together with
a units option of PAGES, indicates positioning to the top of the page
that contains the desired line.

A starting position of END together with a units option of PAGES
indicates starting at the beginning of an imaginary page following
the final page rather than at the beginning of the final page.
Similarily, a starting position of END together with a
units option of LINES indicates starting at an imaginary line
following the final line of the file.

Note that a location of zero pages backward or forward from
the LAST_LINE_PRINTED is the top of the page that was last being
printed.

 ;direction: This parameter specifies whether positioning is
to move forward or backward from the starting position.

 ;starting_position:  This parameter specifies the starting
point for the positioning. BEGINNING indicates starting from the beginning
of the file. END indicates starting from the end of the file.
LAST_LINE_PRINTED indicates starting from the last line that was printed.

 ;preview: This parameter specifies that the indicated number of
lines (starting at the selected new position) are to be displayed at
the station operators terminal.

The position_file subcommand causes the file transfer to be
suspended.  If the preview option is not specified the transfer
restarts automatically at the selected new position.  If the
preview option is specified the operator must restart the
transfer after the preview data has been displayed at the
operators terminal.  Alternatively, the operator can respond to
the previewed data with another position_file subcommand (in
which case the last_line_printed is construed to be the line
just positioned to).

 ;status: See ERROR HANDLING.
\-

If a location parameter integer specifies a position outside
the range of the file (example:  'position_file 50 pages back'
when printing page 48), the file will be positioned to the beginning
or end of the file as the case may be.  This is not
considered to be an error condition.  Nevertheless, if the
preview option is selected, a message indicating that the file
is positioned at the beginning or end will be prefixed at the
beginning of the preview data.

If a search string is given and the string is not found, the
file remains positioned at the last line printed.  In
this case a message indicating that the string was not found
will be prefixed at the beginning of the preview data. If
previewing is not selected, printing will then resume at the last
line printed.

This subcommand is primarily intended for use with printers.
For other output devices and for all transparent mode printers
the only positioning allowed is to the beginning or end of the
file.

\under
EXAMPLES
\nounder

The following equivalent subcommands will all position printer
PR2 to the top of the page preceeding the page that was last
being printed.

 ;;POSF PR2
 ;;POSF PR2 1
 ;;POSF PR2 1 PAGE
 ;;POSF PR2 1 PAGE BACK
 ;;POSF,DN=PR2,L=1,U=P,D=B,SP=LLP

The following subcommand will do the same as the above subcommands
plus it will show a two line preview of the new position on
the operators console.

 ;;POSF PR2 PV=2

The following subcommand will position back to the top of the
page that contains the string 'Page 5-29' and will show the
first four lines of that page on the operators console.

 ;;POSF PR2 'Page 5-29' PV=4

The following subcommand will position back ten lines from the
last line printed.

 ;;POSF PR2 10 LINES

The following subcommand will position the file forward by fifty
pages.

 ;;POSF PR2 50 PAGES FORWARD

The following subcommand will rewind the file.

 ;;POSF PR2 SP=BEGINNING

The following equivalent subcommands  will position the file to the top of
the final page.

 ;;POSF PR2 SP=B
 ;;POSF PR2 1 PAGE BACK SP=END

The following subcommand will position the file to the final line.

 ;;POSF PR2 SP=END U=LINE

The following subcommand will position the file at the end.

 ;;POSF PR2 SP=END L=0

\ 3 Suppress Carriage Control
The purpose of this subcommand is to suppress the
interpretation of carriage control characters in a file being
transferred to a printer.

This subcommand only affects a single file transfer. The device reverts
to interpreting carriage control characters when the next file transfer
begins.

While carriage control interpretation is being suppressed, the carriage
control character at the beginning of each line is included with the line
being printed.

 ;suppress_carriage_control, supcc (
 ;;device_name, dn: name = $required
 ;;status)
\+flowtab;6,11

 ;device_name: This parameter specifies the device
for which carriage control is to be suppressed. If the named
device is not a printer, the subcommand has no effect.

 ;status: See ERROR HANDLING.
\-
\ 3 Terminate transfer
The purpose of this subcommand is to terminate the transfer
of the file to or from the device and for output files to
optionally requeue the file for transfer at some later time.

 ;terminate_transfer, tert (
 ;;device_name, dn: name = $required
 ;;file_disposition, fd: key
 ;;;;requeue
 ;;;;drop
 ;;;;hold
 ;;;keyend = drop
 ;;status)
\+flowtab;6,11

 ;device_name: This parameter specifies the device for which
transfer is to be terminated.

 ;file_disposition:  This parameter specifies the disposition
of the file that was being transferred.
\+item
 . REQUEUE indicates that the file is to be requeued with its
current priority values.
 . DROP specifies that the file is to be discarded.
 . HOLD specifies that the file is to be requeued and is not to
be selected for transfer again until referenced by a SELECT_FILE
subcommand.
\-

An input file will always be dropped if its transfer is terminated
by this subcommand.

 ;status: See ERROR HANDLING.
\-
\ 3 Stop Batch Device

The purpose of this subcommand is to remove a device from service
until it is restarted with a start_batch_device subcommand. It may take
effect immediately (fd = r, d, h, or s) or at the end of the current
file transfer (fd = f).

 ;stop_batch_device, stobd, stop (
 ;;device_name, dn: name = $required
 ;;file_disposition, fd: key
 ;;;;requeue, r
 ;;;;drop, d
 ;;;;hold, h
 ;;;;finish, f
 ;;;;suspend, s
 ;;;keyend = suspend
 ;;status)
\+flowtab;6,11

 ;device_name: This parameter specifies the device
which is to be stopped.

 ;file_disposition:  This parameter specifies the disposition
of the file (if any) being transferred. If no file is being
transferred this parameter is ignored.
\+item
 . REQUEUE, DROP, and HOLD terminate the current file transfer.
Thus the device will be available for selection when it is
restarted. Output files receive the following disposition:
\+item
 . REQUEUE causes the file to be requeued with its
current priority values.
 . DROP causes the file to be discarded.
 . HOLD causes the file to be requeued and to not
be selected for transfer again until referenced by a SELECT_FILE
subcommand.
\-

      For input devices, REQUEUE, DROP, and HOLD all cause the
transfer to be terminated, the partially transmitted file
to be discarded, and the input device to be positioned to the next end
of file and then stopped.

 . FINISH allows the current transfer to continue to completion
before the device is stopped. Thus an output device will be available
for selection when it is restarted, and an input device will be available
to input additional files when it is restarted.
 . SUSPEND specifies that the file transfer is not terminated
but is only suspended. The file
remains assigned to the device and the transfer will be resumed
when the device is restarted.
\-

 ;status: See ERROR HANDLING.
\-
\ 3 Start Device
 The purpose of this subcommand is to resume any suspended transfer
to or from the device and/or to re-instate the device as a candidate
for selection.

 ;start_batch_device, stabd, start (
 ;;device_name, dn: name = $required
 ;;status)
\+flowtab;6,11

 ;device_name: This parameter specifies the device
which is to be started.

 ;status: See ERROR HANDLING.
\-
\ 2 File Selection Subcommands
\ 3 Select File
The purpose of this subcommand is to give the selected file the highest
possible priority within the station's queue of output files.

The file must be a candidate for printing at the station being operated.
That is, it must be present in the station's queue of output files.

 ;select_file, self (
 ;;name, n: name = $required
 ;;device_name, dn: name = $optional
 ;;status)

\+flowtab;6,11
 ;name: This parameter specifies the name of the file
being selected. Either the system supplied name or the
user supplied name may be used.

 ;device_name:  This parameter specifies the device to which
the file is to be transferred.  If this name is specified, the
normal selection rules for matching a file with a device, such
Rs forms code, page size, external device characteristics,
device type, etc., will be overridden (caveat selector).

If this parameter is omitted, the file will be moved to the
head of the priority chain but the normal device selection rules
for the station will be used to determine which, if any, of the
station's output devices matches the attributes of the file.

The device must be an output device.

 ;status: See ERROR HANDLING.
\-
\ 3 Terminate Queued Output
The purpose of this subcommand is to delete files from the station's output
queues.  After this command successfully executes, the file(s) will no longer
exist in any output queue.

 ;terminate_queued_output, terqo (
 ;;name, names, n: list of name = $required
 ;;status)

\+flowtab;6,11

 ;name:  This parameter specifies the queue file(s) to be terminated.
Name may be either the system supplied name or the user supplied name.

 ;status: See ERROR HANDLING.
\-
\ 2 Station Status Subcommands
\ 3 Display Batch Device Status
The purpose of this subcommand is to display the attributes
and status of a batch station device.

 ;display_batch_device_status, disbds (
 ;;device_name, dn: any of
 ;;;;list of name
 ;;;;key
 ;;;;;printers
 ;;;;;plotters
 ;;;;;punches
 ;;;;;readers
 ;;;;;all
 ;;;;keyend
 ;;;anyend = $required
 ;;display_option, do:key
 ;;;;all,a
 ;;;;brief, b
 ;;;keyend = brief
 ;;output, o: file reference = $output
 ;;status)

\+flowtab;6,11
 ;device_name: This parameter specifies the name of the device(s)
whose status is to be displayed.

 ;display_option: This parameter specifies which items are to be displayed.
ALL indicates that all the items are to be displayed. BRIEF indicates
that only device name, device status, transfer status, percent
complete, and last unsolicited message are to be displayed.

 ;output: This parameter specifies the file where
the output is to be displayed.

 ;status: See ERROR HANDLING.
\-

The following information will be displayed:
\+item
 . device name
 . device status
 . device type
 . external device characteristic strings
 . file acknowledgement status
 . last unsolicited message concerning the device
 . page width
 . terminal model
 . transfer status
\-
For output devices the following additional information
will be displayed:
\+item
 . banner highlight field
 . banner page count
 . code set
 . device aliases
 . forms size
 . forms code strings
 . maximum file size
 . page length
 . transmission block size
 . undefined fe action
 . unsupported fe action
 . vertical print density
 . vfu image load options (none, init, oper, user)
 . vfu load procedure
 . information about the file being transferred to the device
\+item
 - system supplied file name
 - user supplied file name *
 - system supplied job name of generating job *
 - user supplied job name of generating job *
 - login user name of generating job *
 - family name of generating job *
 - percent complete
\-
\-
For input devices the following additional information
will be displayed:
\+item
 . information about the file being transferred from the device
\+item
 - user job name *
 - destination name *
 - approximate lines transferred so far *
\-
\-
In the display_station utility, the items marked with an asterisk (*)
above will only be displayed when the user owns the associated file.
\ 3 Display Station Status
The purpose of this subcommand is to display the
status of the batch i/o station being operated.

 ;display_station_status, disss (
 ;;output, o: file reference = $output
 ;;status)

\+flowtab;6,11
 ;output: This parameter specifies the file where
the output is to be displayed.

 ;status: See ERROR HANDLING.
\-

The following information will be displayed:
\+item
 . Station name.
 . Control facility name.
 . Station alias list.
 . List of devices showing device type, device status,
and transfer status for each.
 . Number of files queued for the station.
 . File Acknowledgement required (yes/no)
 . Fixed console device name.
 . Station usage (public/private).
 . Default job destination.
 . Destination unavailable action.
 . PM message action.
 . Store and forward destination. (not in 1.2.1 or 1.2.2)
\-
\ 3 Display Station Queue Status
The purpose of this subcommand is to
display the status of the queue of output files destined
for the station.

 ;display_station_queue_status, dissqs (
 ;;display_option, do:key
 ;;;;all,a
 ;;;;brief, b
 ;;;keyend = brief
 ;;output, o: file reference = $output
 ;;status)

\+flowtab;6,11

 ;display_option: This parameter specifies which items are to be displayed.
ALL indicates that all the items are to be displayed. BRIEF indicates
that only the summaries for printers, plotters, and punches are to be
displayed.

 ;output: This parameter specifies the file where the
information is to be displayed.

 ;status: See ERROR HANDLING.
\-

The following information will be displayed:
\+item
 . Number of files in the queue.
 . Each of the external device characteristic strings in
the queue and the number of files with that string.
 . Each of the forms code strings in the queue with the number
of files for each.
 . Explicitly requested device names in the queue and the number
of files for each.
 . Each destination name (station name and station alias names)
and the number of files for each.
 . Each device type (printer, plotter,punch) and the number
of files for each.

In addition to the number of files, the total byte length in kilobytes,
the age of the oldest file, and the average file age will be
shown for each category.
\-
\ 3 Display Station Queue Entries
The purpose of this subcommand is to display information about
specific entries in the station output queue.

 ;display_station_queue_entry, dissqe (
 ;;name, names, n: any of
 ;;;;list of name
 ;;;;key
 ;;;;;top_ten
 ;;;;;all
 ;;;;keyend
 ;;;anyend = $required
 ;;display_option, do:key
 ;;;;all,a
 ;;;;brief, b
 ;;;keyend = brief
 ;;output, o: file reference = $output
 ;;status)

\+flowtab;6,11

 ;name:  This parameter specifies the queue file(s) about
which information is to be displayed.  Name may be either the
system supplied name or the user supplied name.  TOP_TEN
specifies that information is to be displayed about ten files
that are top candidates for transfer.  All indicates that
information is to be displayed about all the queue entries.

 ;display_option: This parameter specifies which items are to be displayed.
ALL indicates that all the items are to be displayed. BRIEF indicates
that only the system supplied file name, user file name, file owner
identification, and file length are to be displayed.

 ;output: This parameter specifies the file where the
information is to be displayed.

 ;status: See ERROR HANDLING.
\-

The following information will be displayed with each entry:
\+item
 . System supplied file name.
 . User file name.
 . System supplied job name.
 . User supplied job name.
 . Login family name and login user name of generating job.
 . Time enqueued (when file availability message was received
by SCFS.
 . Current position in queue.
 . Priority.
 . Destination name (i.e. station name or station alias name)
 . Copies requested.
 . Page format (continuous, burstable, non-burstable).
 . Device type (printer/plotter).
 . Data mode (coded, transparent).
 . Explicit device or alias name.
 . File length.
 . External device characteristics string.
 . Forms code string.
 . Page width.
 . Page length.
 . Vertical print density.
 . VFU load image name.
\-
In the display_station utility, only files that the user owns will be
displayed.
\ 2 Unsolicited Operator Messages.
Unsolicited messages to the operator can be caused by
the following events.
\+item,n
 . A PM message is encountered in an output file.
 . A file positioning preview message arrives.
 . A file acknowledgement message arrives.
 . An input file error (route_job or user validation) occurs.
 . An initial vfu load procedure error occurs.
 . A control facility failure/recovery message arrives.

\-

Users in the display_station utility will not receive any unsolicited
messages.

When a PM message is sent to the operator, the data transfer
to the affected device is automatically suspended.  The operator
must use the start subcommand to get the transfer restarted.  PM
messages can be selected or suppressed for a station via the
DEFIOS or DEFUIOS station definition commands.

When a file positioning preview message is sent to the operator
the file transfer is suspended until a start subcommand is given.
The operator can give an additional positioning subcommand at
this time instead of the start subcommand.

The File Acknowledgement messages are purely informational
and do not cause suspension of a device.  They can be selected
or suppressed via the station definition commands.  If they are
selected for the station they cannot be suppressed for
individual devices.  If not selected for the station, they can
be selectively chosen for each device via the
change_batch_device_attribute operator subcommand.

If an input file error message is received, the operator must
correct the route_job or login statement as appropriate
before the input file can be transferred successfully.

If an initial vfu load procedure error message is received
the operator must correct the statements within the vfu load
procedure before the device can be successfully initiated.

Control facility failure/recovery messages may require the
operator to wait for recovery to complete before issuing
further batch station subcommands.

If an operator issues a NOS/VE SCL command from within the i/o
station utility, the appearance of the unsolicited messages at
the operators terminal may be delayed until the SCL command
completes.
