Hogan setup menu
The menu that appears for option H (HOGAN) on the Hogan Setup Menu is shown in following figure. The Hogan Setup Menu is used to select screens where you can list the data sets to be allocated to Hogan ddnames. The four screens can be selected individually or all together as a complete sequence. The screens for these options are described in the following subsections:
Hogan Setup Menu
OPTION ===>
1 MONITOR - Hogan activity log dataset
2 PRINT - Hogan report file dataset
3 SNAPDD - Hogan SNAP dump dataset
4 SYSPRINT - Hogan formatted dump dataset
A ALL - Display all of the above in succession
Press ENTER to process or enter END command to terminate
Hogan Activity Log (Monitor Data set) screen
Data related to PEM calls is recorded in the Hogan monitor file. This file can be used as input to Hogan report programs that list, summarize, or analyze PEM activities. If it is not required, leave the DSNAME field blank.
If required, the Hogan monitor file is usually allocated as a variable block sequential file (VB). If you are using this file for debugging and expect an abend, an LRECL of 55 and a BLKSIZE of 59 are recommended to limit the loss of data in buffers. If an abend is not anticipated, then a larger block size is more efficient.
Hogan Monitor Data set Screen
COMMAND ===>
Enter a DSNAME, DUMMY, TEMP, TERM, SYSOUT, or leave blank for no allocation.
DSNAME ===>
DISP ===>
Storage Class ===> Process Options for New Datasets:
Unit ===> SYSDA Before Allocation ===>
Volume ===> Upon Deallocation ===>
Data Class ===> Valid Process Options:
Space Units ===> TRK D (Delete) K (Keep) ? (Prompt)
Primary ===> 2
Secondary ===> 2
RECFM ===> V85
LRECL ===> 55
BLKSIZE ===> 59
Note: Changes made to this screen override installed defaults
Press ENTER to process or enter END command to terminate
The fields on the Hogan Monitor Data set screen (above figure) are:
DSNAME
If it is not required, leave the DSNAME field blank.
If a dsname is required, enter a qualified dsname (enclosed in quotes), DUMMY, TEMP, TERM, or SYSOUT (JES data set), or leave this field blank. If the dsname is entered without quotes, the user ID (or other dsname high-level qualifier) is prefixed and quotes are added. If the DSNAME field is left blank, the data set is not allocated.
DISP
Valid values for the DISP field are:
S | Shared (SHR) |
M | Modified (MOD) |
O | Old |
N | New |
If you are allocating an existing data set, you can specify a disposition of SHR, OLD, or MOD. If you do not enter a value in the DISP field, a SHR disposition is assumed. Data sets with a disposition of SHR can be concatenated.
If the DSNAME field contains a value of DUMMY, TEMP, TERM, or SYSOUT, leave the DISP field blank.
Enter a disposition of NEW for a new or temporary data set. If you are allocating a new (DSNAME='qualified-dsname') or temporary file (DSNAME=TEMP), you must enter values for all the fields below except Volume and Unit, which are optional for a new or temporary file.
If you specify a new data set, it is allocated before your debugging session begins and deallocated immediately after your debugging session ends. The fields for the Process Options for New Data sets let you specify how the new data set is to be allocated and deallocated.
For more information about NEW, OLD, MOD, or SHR data set dispositions, See to Types of Files That Can Be Allocated.
Storage Class
Enter the storage class name defined by your site that contains the data set attributes related to the storage occupied by the data set. A storage class is displayed only when SMS (Storage Management Subsystem) is being used.
Unit
If your site requires it, you must supply a value for the Unit field. Otherwise, leave blank for the default value.
Volume
If your site requires it, you must supply a value for the Volume field. Also enter the volume if you are specifying an uncataloged data set. Otherwise, leave blank for the default value.
Data Class
Enter the data class name defined by your site that contains the data set attributes related to the allocation of the data set. A data class is displayed only when SMS (Storage Management Subsystem) is being used.
Space Units
Valid values are TRK, CYL, or a block size (1-32760).
Primary
Valid values are 0-32760.
Secondary
Valid values are 0-32760.
RECFM
If required, the Hogan monitor file is usually allocated as a variable block sequential file (VB).
LRECL
If you are using this file for debugging and expect an abend, an LRECL of 55 is recommended to limit the loss of data in buffers.
BLKSIZE
If you are using this file for debugging and expect an abend, a block size of 59 is recommended to limit the loss of data in buffers. If an abend is not anticipated, then a larger block size is more efficient.
If you are allocating a DUMMY or SYSOUT file (DSNAME=DUMMY or DSNAME=SYSOUT), you must enter the block size.
Before Allocation
Valid process options are:
D | Automatically delete the old file, if one exists, before a new data set is allocated. |
K | Always keep the old data set. |
? | Display the Data Set Disposition screen each time a data set is to be allocated, so that you can decide whether to delete or keep the old data set. |
Upon Deallocation
Valid process options are:
D | Automatically delete the new file after every debugging session. |
K | Always keep the new data set. |
? | Display the Data Set Disposition screen each time a data set is to be deallocated, so that you can decide whether to delete or keep the new data set. |
Hogan Report File (Print Data set) Screen
The Hogan print file is used frequently by Hogan programs to store reports or other output from application programs. The Hogan Print Data set screen is shown in following figure.
Hogan Print Data set Screen
COMMAND ===>
Enter a DSNAME, DUMMY, TEMP, TERM, SYSOUT, or leave blank for no allocation.
DSNAME ===> PRINT.LIST
DISP ===> NEW
Storage Class ===> Process Options for New Datasets:
Unit ===> Before Allocation ===>
Volume ===> Upon Deallocation ===>
Data Class ===> Valid Process Options:
Space Units ===> TRK D (Delete) K (Keep) ? (Prompt)
Primary ===> 10
Secondary ===> 10
RECFM ===> FBA
LRECL ===> 133
BLKSIZE ===> 6118
Note: Changes made to this screen override installed defaults
Press ENTER to process or enter END command to terminate
If needed, this Hogan file is usually allocated with a RECFM of FBA, LRECL of 133, and BLKSIZE of 6118.
Consult a batch Hogan PROC at your site if you are unsure of the dsname or other parameters. If the PRINT ddname is not needed, leave the DSNAME field blank.
The fields on the Hogan Print Data set screen are similar to the Monitor screen. See to Hogan Activity Log (Monitor Data set) Screen for a description of these fields.
Hogan SNAP Dump (SNAPDD Data set) Screen
The Hogan SNAPDD file is used by Hogan to store SNAP dumps. Unlike a SYSUDUMP, a SNAP dump is not usually a printout of the entire region. A SNAP dump provides a “snapshot” of the particular storage pool you want to see, as specified by your Hogan dump options. The Hogan SNAPDD Data set Screen is shown in following figure.
Hogan SNAPDD Data set Screen
COMMAND ===>
Enter a DSNAME, DUMMY, TEMP, TERM, SYSOUT, or leave blank for no allocation.
DSNAME ===> DUMMY
DISP ===>
Storage Class ===> Process Options for New Datasets:
Unit ===> Before Allocation ===>
Volume ===> Upon Deallocation ===>
Data Class ===> Valid Process Options:
Space Units ===> D (Delete) K (Keep) ? (Prompt)
Primary ===>
Secondary ===>
RECFM ===> FBA
LRECL ===> 133
BLKSIZE ===> 6118
Note: Changes made to this screen override installed defaults
Press ENTER to process or enter END command to terminate
The recommended DCB parameters for the SNAPDD data set are RECFM=FBA, BLKSIZE=6118, and LRECL=133.
Consult a batch Hogan PROC at your site if you are unsure of the dsname. If a SNAPDD file is not required, leave the DSNAME field blank.
The fields on this screen are similar to the Monitor screen. See to Hogan Activity Log (Monitor Data set) Screen for a description of these fields.
Hogan Formatted Dump (SYSPRINT Datas et) Screen
The Hogan SYSPRINT file is used by Hogan to store PEM formatted dumps. Before running a transaction, set up your Hogan dump options to print the contents of certain control blocks or areas in main memory when an abend occurs. The Hogan SYSPRINT Data set screen is shown in following figure.
Hogan SYSPRINT Data set Screen
COMMAND ===>
Enter a DSNAME, DUMMY, TEMP, TERM, SYSOUT, or leave blank for no allocation.
DSNAME ===> SYSPRINT.LIST
DISP ===> NEW
Storage Class ===> Process Options for New Datasets:
Unit ===> Before Allocation ===>
Volume ===> Upon Deallocation ===>
Data Class ===> Valid Process Options:
Space Units ===> TRK D (Delete) K (Keep) ? (Prompt)
Primary ===> 10
Secondary ===> 0
RECFM ===> FBA
LRECL ===> 133
BLKSIZE ===> 6118
Note: Changes made to this screen override installed defaults
Press ENTER to process or enter END command to terminate
The recommended DCB parameters for the SYSPRINT data set are RECFM=FBA, BLKSIZE=6118, and LRECL=133.
Consult a batch Hogan PROC at your site if you are unsure of the dsname. Most sites allocate this ddname to DUMMY for debugging rather than leaving it blank. This conforms to common batch and debugging message region usage.
The fields on the Hogan SYSPRINT Data set screen are similar to the Monitor screen. See to the Hogan Activity Log (Monitor Data set) Screen for a description of these fields.