Menu Name
Name Of The Display Text Source Member •••••••••••••••••••••••••
(0)Library That Contains The Source Message Member •••••••••••••••• #LIBRARY Library To Contain The Format Load Member •••••••••••••••••••••• #LIBRARY If The New Member Will Replace An Existing Load Member,
Enter REPLACE •••••••••••••••••••••••••••••••••••••••••••••
(0)If The Load Member Is To Remain In The Output Library,
Enter KEEP ••••••••••••••.•••••••••••••••••••••••••••••••••
(0)If Creating A Free-Format Menu, Enter FREEFORM •••••••••••••••••
(0)In this example, a menu called MENUOl is to be built. Display text source member MENU01 DT is in a library called ULlB1.The new menu is to be placed in a library called U LI B2. The operator enters the parameters as follows and presses the Enter/Rec Adv key to run the BLDMENU procedure:
BLDMENU PROCEDURE OPTIONAL-CO)
Creates the library members required to display a menu.
Menu Name t1ENUOl
Name Of The Display Text Source Member ••••.••••••••.••••••••••• MENUOIDT (0) Library That Contains The Source Message Member •••••••••••••••• ULIBl
Library To Contain The Format Load Member •••••••••••.•••••••••• ULIB2 If The New Member Will Replace An Existing Load Member,
Enter REPLACE ••••••••••••••••••••••••.•••••.••••••••••••••
(0)If The Load Member Is To Remain In The Output Library,
Enter KEEP •••••••••••••••••••••••••••••••••.••••••••••••••
(0)If Creating A Free-Format Menu, Enter FREEFORM •••••••••••••••••
(0 )HISTCRT Procedure Function
~
The HISTCRT procedure displays selected entries from the history file on the display screen at the requesting display station. The HISTCRT procedure display is similar to the HISTORY procedure display with SYSLIST CRT specified.
The HISTCRT procedure cannot be used to display entries logged to the history overflow file. To list entries logged to the history overflow file, you must use the HISTORY procedure described later in this chapter.
For information about the entries logged to the history file and the history overflow file, see the description of the HISTORY procedure.
When the HISTCRT procedure is run, the most recent entries logged to the history file are displayed first. The following is an example of the initial HISTCRT display:
HISTORY SCROLL WKSTN USER JOB NAt1E TIME
// RUN X2 LGA X2095834 09.59.28
X2 LGA X2095834 09.59.30 // DEFINEPN INAME-PHONTEMP,INLIB-#LIBRARY,
// OUTLIB-#lIBRARY,MODE-NODELAY X2 LGA X2095834 09.59.31
// Et~D X2 LGA X2095834 09.59.32
SYS-8621 OPTIONS ( 3) PNLM X2 LGA X2095834 09.59.34 X2 LGA X2095834 09.59.34 SOURCE MEMBER PHONTEMP NOT FOUND IN SPECIFIED LIB
3 X2 LGA X2095834 09.59.39
X2 LGA X2095834 09.59.41
"
*EJ 09.58.34 09.59.41 00.01.07 07/15/81 LGA X2 DEFH~EPN
HISTCRT X2 LGA X2100218 10.02.19
// LIBRARY NAME-O X2 LGA X2100218 10.02.19
// MEMBER USER1-#~MSG2 X2 LGA X2100218 10.02.19
// *
5039 X2 LGA X2100218 10.02.19HISTCRT PROCEDURE EXECUTING X2 LGA X2100218 10.02.20
// LOAD $HSML X2 LGA X2100218 10.02.20
// RUN- X2 LGA X2100218 10.02.21
// DISPLAY SYSTEM-tm X2 LGA X2100218 10.02.22
// END X2 LGA X2100218 10.02.22
NO MORE ENTRIES IN HISTORY FILE
Ct1D7-Etm OF JOB CMD8-DISPLAY OLDEST CMD9-DISPLAY NEWEST
DIRECTION- B SCAN DATA- WKSTN-
USER-....
..,
HISTCRT Procedure 2·93
Scan values may be entered at the bottom of the HISTCRT display. If scan values are entered at the bottom of this display, the HISTCRT procedure searches the history file for entries matching the scan values. A scan direction of forward (F) or backward (B) can be specified; the default value is B. SCAN DATA applies only to the text portion of the history file entries; WKSTN applies only to the control information portion of the entries. The following scan values can be specified:
DIRECTION
SCAN DATA
WKSTN USER
One alphabetic character, either F for a forward scan, or B for a backward scan; the default value is B.
A string of 1 through 20 alphameric characters to be searched for within the text portion of the history file entries.
A 2-character, alphameric work station ID.
A 1 - to 8-character, alphameric user I D can be entered only if SYSTEM was specified in the HISTCRT procedure. USER does not appear if HISTCRT USER was entered.
When the Enter/Rec Adv key is pressed after keying in a scan value or values in the above fields, the HISTCRT procedure searches the history file for the specified values. If multiple scan values are specified, all of the specified conditions must be met for the scan to be successful.
If a forward scan is specified, the scan begins with the first history file entry on the currently displayed screen. If the scan is successful, a screen of history file entries is displayed with the first entry containing the specified characters.
All entries that satisfy the scan are shown in high intensity and are undefined.
To continue the scan operation with the same values, press the Enter/Rec Adv key. The scan continues with the next entry after the last currently displayed entry. If the specified characters are not found in the history file, a message is displayed.
If a backward scan is specified, the scan begins with the last entry on the currently displayed screen and searches backward through the history file. If the scan is successful, a screen of history file entries is displayed with the last entry containing the specified scan characters. To continue the scan in a backward direction, press the Enter / Rec Adv key. The scan continues with the entry previous to the first currently displayed entry. If the specified characters are not found in the history file, a message is displayed.
The HISTCRT procedure provides the following functions through the use of the command and function keys:
Key Roll Up
Roll Down
Function
Pages forward through the history file entries. The roll factor is initially set to the number of entries that can be displayed on the screen at one time. When the last, or the most recent, entry in the history file is displayed, a "Iast entry" message is displayed. If the Roll Up key is used when the last entry is displayed, the current screen is redisplayed. The roll factor can be changed using Cmd key 3.
If SYSTEM was specified in the HISTCRT procedure, history file entries are displayed as they are logged to the history file. The newly logged entries are marked with the symbol > when displayed.
Pages backward through the history file entries. The roll factor is initially set to the number of entries that can be displayed on the screen at one time. When the first, or the oldest, entry in the history file is displayed, a "first entry" message is displayed. If the Roll Down key is used when the first entry is
displayed, the current screen is redisplayed. The roll factor can be changed using Cmd key 3.
HISTCRT Procedure 2-95
Key
IIOUTLIB-#LIBRARY,MODE-NODELAY X2 LGA X2095834X2095834
Key Cmd key 4
Cmd key 5
Function
Used to specify whether the following control information for each entry to the history file is displayed:
• Work station 10
• User 10
• Job name
• Time
If the control information is currently displayed, use Cmd key 4 to remove the control information. If the control inform,ation is not currently displayed, use Cmd key 4 to display the control information.
Used to specify whether nonviewed entries to the history file are displayed. Viewed entries are those that were displayed prior to entry into the history file.
Nonviewed entries include *E entries and all OCl statements generated via procedures.
If nonviewed entries are currently displayed, use Cmd key 5 to remove the nonviewed entries. If only viewed entries are currently displayed, use Cmd key 5 to also display nonviewed entries.
HISTCRT Procedure 2-97