HASPGEN Parameters for HASP Version 4

In an OS/VS2 Release 1 environment, defines the priority level of the Automatic Priority Group.

Specifies the inclusion or exclusion of code in HASP to recognize automatically when a card reader available to HASP becomes ready. Acceptable values are YES (include the code) and NO (exclude the code).

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of support for HASP MULTI-LEAVING Remote Job Entry.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of support for the 2770 Data Communication System.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of support for the 2780 Data Transmission Terminal.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of support for the 3780 Data Communication System.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of support for the Space Compression/Expansion feature of 2770 and 3780 terminals.

Specifies inclusion (YES) or exclusion (NO) of the HASP Remote Job Entry Printer Interrupt feature for binary synchronous hardware terminals. If this feature is included, the remote terminal operator may interrupt printing to transmit jobs or HASP commands to HASP.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of support for the Printer Horizontal Format Control feature of 2770, 2780 and 3780 terminals.

Specifies the character that will be interpreted as the System/370 hardware-defined backspace character X'16'. When the $BSPACE character is entered, it will be removed from the command text, along with the previously entered character (if any). Characters following the $BSPACE character will be shifted left to replace the characters that have been removed. $BSPACE is specified using the two hexadecimal digit representation of the EBCDIC character.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of code to recognize an EM (end of media) punch in card images nontransparently by the 2780 Data Transmission Terminal.

Specifies the size in bytes of each HASP buffer. If the value specified is not a multiple of eight, it will be adjusted upward to a multiple of eight. &BUFSIZE must be an integer not larger than 4008 and not smaller than (400+&NUMDA*&NUMTGV/8).

Specifies the interval, in seconds, at which selected HASP information will be checkpointed for warm start.

Subscripted variable symbols &CLS(n) specify HASP job classes. The nth HASP logical partition may select, for OS execution, a job from the HASP job queue, only if the job's class (specified by the user or defaulted to A) specified in the &CLS(n) parameter or specified by the operator in a "$TImm,list" command for the logical partition, where mm=&PID(n). Each specification must be a 1- to 53-character string of valid HASP job classes. The same HASP job class may appear in two or more specifications.

Specifies inclusion (YES) or exclusion (NO) of debugging code in the generated HASP system.

Specifies a delay time in microseconds to be applied by the HASP Remote Terminal Access Method when transmitting to either MULTI-LEAVING System/360 Model 20, Submodel 2, 4, or 6, or to a 2922 remote terminal over a 19,200 baud or greater teleprocessing line.

Specifies whether inline printer setup will be allowed (YES) or not allowed (NO) for data sets whose SYSOUT class matches the job message class.

Specifies the default estimated execution time, in minutes, for a job. The specified value must be an integer greater than zero.

Specifies the default estimated print line count, in thousands of lines, for a job. The specified value must be an integer greater than zero.

Specifies the default estimated punched card count, in cards, for a job. The specified value must be an integer greater than zero.

Specifies inclusion (YES) or exclusion (NO) of 3211 Variable Forms Control Buffer loading compatibility. If set to YES, the "V" specified FCB image is generated and the code to support the $TF... command is included.

Specifies the maximum allowable value for job output copies requested in the JOB card accounting field or on the /*JOBPARM card. The value specified must be an integer between 1 and 255 inclusive.

Specifies the default maximum number of lines to be printed per page of a job's printed output.

LINEmm statements specify the characteristics of teleprocessing lines to be used by HASP Remote Job Entry. Lines must be defined consecutively, starting with LINE01. Each specification must be a 5-character string of the form: where the letters represent the following:

Specifies inclusion (YES) or exclusion (NO) of code to support the HASP Job Log.

Specifies whether the alternate long form of HASP commands is available (YES) or unavailable (NO) to the operator.

Specifies the maximum number of job classes which may be specified via the HASP operator command "$TIn,list" for a HASP logical partition. The value must be an integer from 1 to 64 inclusive.

Specifies the maximum number of job that can be in the HASP system at any one time. The value must be an integer greater than zero.

Specifies the number of HASP logical partitions to be defined. The value must be an integer between 1 and 63 inclusive.

Specifies the maximum number of jobs that may concurrently be active in the HASP execution phase. The value must be an integer greater than zero.

Specifies a minimum threshold of HASP buffers below which a warning message is produced. The specification should be an integer value, representing the minimum number of buffers determined necessary for the installation (see &NUMBUF).

Specifies the lower bound for the number of free Job Output Elements. When the free count drops below &MINJOES, no new work still be added to the in-storage queues until print or punch activity raises the free count. the installation (see &NUMBUF).

Specifies the size in bytes of each HASP MULTI-LEAVING buffer. The value must be a positive integer no greater than &TPBFSIZ.

Specifies the number of input/output buffers to be included in the HASP load module. It should normally be set to reflect the total number of buffers required for proper operation of HASP. However, because HASP will automatically use free space in its region to dynamically construct additional buffers, there are circumstances when &NUMBUF may be set to a value less than the actual number of buffers required for proper HASP operation. In this case, it is assumed that sufficient additional buffers will be dynamically obtained from free space in the HASP region to provide an adequate total number of buffers (see &MINBUF and &RESCORE).

Specifies the maximum number of classes that a printer may simultaneously select. Because there are 36 unique SYSOUT classes, the maximum allowable value of &NUMCLAS is 36.

Specifies the maximum number of direct access volumes that can be mounted concurrently as SPOOL volumes. The value must be a positive integer.

Specifies the number of Data Definition Tables (DDTs) to be assembled into HASP. The specification should be an integer between 3 and 256, and equal to:

where

Specifies the number 2520 pseudo-punches to be used by the generated HASP system as internal readers.

Specifies the number of Job Output Elements to be generated for queuing of output work to printers and punches.

Specifies the largest teleprocessing line identification number (mm in LINEmm) and the number of line definitions to be generated in the HASP system. The value must be an integer between 0 and 99, inclusive. The value of &NUMLNES automatically becomes the value of &NUMRJE, unless &NUMRJE is specified explicitly.

Specifies the number of overlay areas to be provided for the HASP Overlay feature. The value must be an integer greater than zero.

Specifies the number of OS consoles that HASP will support for redirection of HASP command responses. The value must be an integer between 1 and 32, inclusive, and should reflect the number of OS consoles defined at system generation.

Specifies the maximum number of physical printers HASP may use to print job output. HASP supports 1403, 3211 and 3800 printers (if also supported by the host operating system). The value must be a positive integer less than or equal to 99.

Specifies the maximum number of physical punches HASP may use to punch job output. HASP supports 3525, 2540 and 2520 card punch devices. The value must be a positive integer less than or equal to 99.

Specifies the maximum number of physical card readers HASP may use to read OS job streams. HASP supports 3505, 2540 and 2501 card readers. The value must be a positive integer less than or equal to 99.

Specifies the largest remote terminal identification number (nn in RMTnn) and thus the remote terminal definitions to be used by the generated HASP system. The value must be a positive integer less than or equal to 99.

Specifies the number of HASP SMF buffers to be assembled into the generated HASP system. The value must be an integer greater than or equal to zero.

Variable symbol &NUMTGV specifies the number of units (track groups) into which each SPOOL volume will be divided for HASP allocation purposes. The specification must be a positive integer no greater than the number of tracks on the SPOOL device with the fewest tracks.

Specifies the number of HASP teleprocessing buffers (for HASP RJE) to be assembled into the generated HASP system. The value must be an integer greater than or equal to zero.

Specifies the maximum number of HASP remote terminal (including MULTI-LEAVING) printed output streams that can be active simultaneously. The value must be an integer greater than or equal to zero.

Specifies the maximum number of HASP remote terminal (including MULTI-LEAVING) punched output streams that can be active simultaneously. The value must be an integer greater than or equal to zero.

Specifies the maximum number of HASP remote terminal (including MULTI-LEAVING) input streams that can be active simultaneously. The value must be an integer greater than or equal to zero.

Specifies the number of HASP Console Message Buffers (CMBs). The value must be an integer greater than 2.

Specifies a HASP overlay level to be used for assembly of the various HASP control sections. Any potential overlay code defined (by the $OVERLAY macro) with a residence factor greater than &OLAYLEV will be assembled as resident code rather than overlay code. &OLAYLEV must be an integer between 0 and 15, inclusive.

Specifies the size in bytes of a table used to hold REP data for true overlay code. The REPs associated with a particular section of true overlay code will be applied to that code every time it is brought into main storage from the HASP overlay library. &OLAYLEV must be either 0, or an integer not less than 10.

Subscripted variable symbols &OSC(n) specify OS job classes. A job selected by HASP logical partition n will be submitted to OS with the job class &OSC(n). Each specified value must be a single letter from A to O, inclusive.

Specifies inclusion (YES) or exclusion (NO) of the HASP OS Input SPOOLing option. If &OSINOPYES and a DD * or DD DATA statement specifies the DCB keyword, HASP will pass the DD statement and the data following it to the OS Reader/Interpreter; OS will perform input SPOOLing. If &OSINOPT=NO, or if &OSINOPT=YES and no DCB parameter is specified on the DD * or DD DATA statement, HASP will spool the input data.

Specifies the action to be taken when a job exceeds its estimated print lines or punched cards. The value must be 0, 1 or 2. For &OUTPOPT=2, output excession causes the job to be cancelled with a dump. For &OUTPOPT=1, output excession causes the job to be cancelled without a dump. For &OUTPOPT=0, output excession does not cause the job to be cancelled.

Specifies the interval, in print lines or punched cards, whichever is appropriate, at which messages will output limit excession messages will be written to the console. The value must be an integer greater than zero.

Subscripted variable symbols &PID(n) specify the identifiers to be used with for each HASP logical partition. Each value must be a unique 1- or 2-character string.

Subscripted variable symbols &PRI(n) specify OS job priorities. A job selected by HASP logical partition n will be submitted to OS with the job priority &PRI(n). Each value must be an integer between 0 and 13, inclusive.

Specifies the number of print lines to appear on each HASP separator page for output printed on local printers. The value must be an integer greater than or equal to zero. If zero is specified, no separator page will be printed on local printers.

Specifies a HASP priority to be associated with the HASP Priority Aging feature. A job will not be priority-aged if its HASP priority is or becomes greater than or equal to &PRIHIGH. The value must be an integer between 0 and 15, inclusive.

Specifies a HASP priority to be associated with the HASP Priority Aging feature. A job will not b priority-aged unless its HASP priority is initially at least &PRILOW. The value must be an integer between 0 and 15, inclusive.

Specifies the amount by which a job's HASP priority will be incremented in 24 hours by the HASP Priority Aging feature. For example, if &PRIRATE=3, a job's priority will be incremented by one for every eight hours it remains in the system. But a job's priority will not be incremented unless it is at least &PRILOW, and will not be incremented above &PRIHIGH. The value must be an integer greater than or equal to zero. If &PRIRATE is specified as zero, Priority Aging is excluded from the generated HASP system.

Specifies the printer buffering option to be used for local HASP printers. The value must be either 1 (for single buffering) or 2 (for double buffering).

Specifies the 1- to 4- character name of the forms control buffer image or carriage tape that HASP initially assumes is mounted on every local printer.

Specifies the translation option for lines of print not directed to 3211 printers. The value must be YES (translate to upper case) or NO (do not translate).

Specifies the name of the print chain or print train that HASP initially assumes is mounted on every local 1403 printer generated with the UCS feature and on every local 3211 printer. The UCS identifier can be modified by the operator individually by printer using operator commands. The value should be one of: AN, HN, PN, QN, RN, UN, A11, H11, P11, U11, or 0.

Specifies the punch buffering option to be used for local HASP punches. The value must be either 1 (for single buffering) or 2 (for double buffering).

Specifies the unit address of a pseudo 2540 reader to be used by HOSRDR to supply jobs to OS. The value must be a valid unit address, specified during OS system generation as a pseudo 2540 reader.

Specifies the unit address of a physical 3505, 2540 or 2501 card reader from which HASP initialization will read REP cards, if requested by the operator. The value must be a valid unit address.

Specifies the unit address of a physical 1403 or 3211 on which each REP card read is to be printed, if printing of REP cards is requested by the operator. The value must be a valid unit address.

Specifies an amount of storage in 1K bytes. HASP will always issue a GETMAIN for additional storage; all additional storage except for &RESCORE * 1K bytes will be used for HASP buffers.

Specifies the type of scan that should be performed on JOB cards processed by the HASP input processor, and specifies whether an illegal JOB card should prevent execution of the associated job.

The specification must be an integer between 0 and 5, inclusive, where the specified values have the following meanings:

Ordinary symbols RMTnn specify the characteristics of remote terminals to be used with HASP Remote Job Entry. Terminals must be defined consecutively, starting with RMT01. Each specification must be a 14-character string of the form:

where the letters represent the following:

Specifies the printer buffering option to be used for all printers at HASP remote terminals. The value must be either 1 (for single buffering) or 2 (for double buffering).

Subscripted variable symbols &RPRI(n) specify job priorities corresponding to intervals defined by subscripted variable symbols &RPRT(n). If a user does not supply a /*PRIORITY control card with his job, the queueing priority is completed as described in Note 1 below. Each &RPRI(n) specification must be an integer between 0 and 15, inclusive.

Subscripted variable symbols &RPRT(n) specify estimated execution times which are associated with the priorities &RPRI(n). Each value must be an integer between 1 and X'FFFFFF'/60, inclusive.

Specifies inclusion (YES) or exclusion (NO) of Rotational Position Sensing (RPS) code for all HASP channel programs directed to direct access devices with the RPS feature.

Specifies the punch buffering option to be used for all punches at HASP remote terminals. The value must be either 1 (for single buffering) or 2 (for double buffering).

Specifies the size in bytes of the largest SMF record to be written by HASP, or the size of one SMF common exit parameter area, whichever is greater. If SMF records are to be written by HASP, the value must be an integer equal to or greater than 228.

Specifies the number of physical spool records in the first extent of SYS1.HASPACE on the primary SPOOL volume to be reserved for operator messages and HASP messages for HASP remote terminals. Each physical record is capable of holding one or more messages for a single remove terminal. Messages are held if they are directed to:

1. Any terminal not signed on.
2. Any signed-on hardware terminal that is currently processing an input or output stream.
3. Any signed-on computer terminal that is not a MULTI-LEAVING terminal with a console.

If a message is to be held but no space is available to hold it, the message is discarded without operator notification.

The value for &SPOLMSG must be an integer greater than or equal to zero. If &SPOLMSG is zero, no messages will be sent to hardware terminals.

Specifies the first five characters of the volume serial of each direct access volume mounted for HASP use as a SPOOL volume. The value must be exactly five characters and must be valid as a volume serial.

Specifies a 4-character alphameric value that will be used as a forms ID when no forms ID is given. &STDFORM also defines the initial setup of all printers and punches at HASP startup.

Specifies the action to be taken when a job's estimated execution time is exceeded. The value must be one of the integers 0, 1, 2 or 4. For &TIMEOPT=4, the job's time limits will not be monitored. For &TIMEOPT=2, time excession causes the job to be cancelled with a dump. For &TIMEOPT=1, time excession causes the job to be cancelled without a dump. For &TIMEOPT=2, &TIMEOPT=1 or &TIMEOPT=0, time excession causes messages to be written to the console.

Specifies the interval, in minutes, at which messages will be written to the console indicating that a job's estimated execution time is exceeded. The value must be an integer greater than zero.

Specifies the size in bytes of each HASP teleprocessing buffer. The value must be a positive integer less than or equal to 32K.

Specifies the number of print lines to appear on each HASP job separator page for printed output directed to any HASP remote terminal. The value must be an integer greater than or equal to zero. If the value is zero, no separator page will be produced on remote printers.

Specifies inclusion or exclusion of the HASP event tracing facility in the generated HASP system. The value defines the number of entries to be generated in the HASP trace table. If &TRACE is zero, even tracing is excluded. The value must be an integer greater than or equal to zero.

Specifies inclusion (YES) or exclusion (NO) of support for TSO STATUS and CANCEL commands for jobs submitted by TSO users through the HASP internal reader.

Specifies inclusion (YES) or exclusion (NO) in the HASP Remote Terminal Access Method of the capability to use USASCII line-control characters as well as EBCDIC line-control characters.

Specifies a time interval in seconds. For hardware terminals, the HASP Remote Terminal Access Method will wait $WAITIME seconds at the completion of processing of any input stream, printed output stream, or punched output stream, to allow the operator to alter the normal sequence of Remote Job Entry operations. The value must be an integer greater than zero.

Specifies optional requeuing for OS output classes specified by &WTRCLAS.

The HASP writer subtask (load module HASPWTR) processes System Message Blocks (SMBs) for jobs queued in the OS output queues defined by &WTRCLAS. After processing a job whose output class is the nth character of &WTRCLAS, HASPWTR examines the nth character of &WCLSREQ. If the nth character of &WCLSREQ is *, HASPWTR deletes the job from the OS job queue. But if the nth character of &WCLSREQ is an OS output class, HASPWTR requeues the job in the OS output queue specified by the nth character of &WCLSREQ (which must be different from any class specified in &WTRCLAS).

The specification must be a string of one to eight characters, each of which is either * or a unique, valid OS output class different from any specified in &WTRCLAS. If more characters are specified in &WCLSREQ than were specified in &WTRCLAS, the excess characters in &WCLSREQ are unused.

Specifies the unit address of a pseudo 1403 printer to be used as a writer to retrieve System Message Blocks (SMBs) from the OS job queue for jobs controlled by HASP. The value must be a valid unit address, specified during OS system generation as a pseudo 1403 printer.

Specifies the OS system output classes to be processed by HASP. The value must be one to eight unique characters, each of which is a valid OS output class different from any specified in &WCLSREQ.

Specifies a list of the job classes to be used with the Execution Batch Scheduling feature. The specified classes are excluded from running jobs outside Execution Batch Scheduling. The value for &XBATCHC must be a string of one to eight characters (letters and numbers) that are valid unique HASP job classes. If &XBATCHC is left at its default value, the generated HASP system will not include Execution Batch Scheduling.

Specifies the first five characters of the name of each OS job to be started internally by HASP when required for the execution of a user job under the Execution Batch Scheduling feature. The value must be a five-character string, with the first character alphabetic or national and the remaining four characters alphameric or national.

Subscripted variable symbols &XLIN(m) specify output record counts which are associated with the priorities &XPRI(n). Each value must be an integer between 1 and 16,777,215.

Subscripted variable symbols &XPRI(m) specify output priorities that correspond to intervals defined by subscripted variable symbols &XLIN(m). If a user does not supply a /*PRIORITY control card with his job, the job's priority is recomputed after execution, based on the actual number of print and punch records it produced. If the job produced p print lines and c punched cards, its output priority will become &XPRI(m), where m is the smallest number for which:

Each value must be an integer between 0 and 15.

Specifies the destination for an output data set designated in the user's JCL as SYSOUT=x. The value must be one of the characters A, B or *. These characters indicate:

1. $$x=A SYSOUT data sets for class x will normally be printed.
2. $$x=B SYSOUT data sets for class x will normally be punched.
3. $$x=* SYSOUT data sets for class x be processed entirely by OS. In this case, HASP will add "UNIT=SYSDA" to the SYSOUT DD statement unless the user has already coded UNIT= information.