SCRIPT/VS processing sequence

A style contains options that tell SCRIPT/VS how to format a document for display or printing. These options include the use of fonts, white space, line lengths, and so forth.

The value you put in the Style field and whether or not you select the Display Style Options and Browse Output options determine this SCRIPT/VS processing sequence:

For the Style field, you can perform one of these actions:
- Enter the name of an existing style.
  You can enter the name of a style you have created or one of the styles SCRIPT/VS creates for you: DRAFT and FINAL. These two styles correspond to the formatting options available in the previous release of SCRIPT/VS Foreground Processing. If you have not defined these options before or if this is your first release of ISPF, the default values for the SCRIPT/VS formatting options are set for you.
  
  If you enter the name of an existing style in the Style field, that style is used for formatting.
- Enter the name of a new style you want to define.
  If you enter a new style name, the name is added to your style list. The new style uses SCRIPT/VS formatting options that are equal to the formatting options of the last style. Step 2 explains what to do to change these options.
- Leave the Style field blank.
  If you leave the Style field blank, ISPF displays the Select SCRIPT/VS Formatting Style panel. This panel displays a list of the available styles. See Selecting a formatting style for more information.
Use a slash to select Display Style Options. ISPF displays the SCRIPT/VS Options for Style panel, which shows the options that are currently being used and allows you to change them. See Changing style options for more information.
If you do not select Display Style Options, ISPF does not display the SCRIPT/VS Options for Style panel.
Enter the appropriate ISPF library and concatenation sequence or data set names. You can display a member list by omitting the member name or by using a pattern. See the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I if you need help entering library or data set names, Input data sets for more information about the concatenation sequence, and the Displaying Member Lists section of the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I for more information about displaying member lists.
Enter your password in the Password field if your input data set is password-protected. See Password protection for more information.
Use the List ID field to tell ISPF what to name the output SCRIPT/VS listing. See List data sets for more information.
Use a slash to select the Browse Output option. ISPF displays your output in Browse mode after it has formatted.
If you do not select the Browse Output option, ISPF skips Browse mode and displays a Foreground Print Options for Style panel, shown in Figure 1.
Once all the input parameters have been specified, press Enter to call SCRIPT/VS.
Communication with SCRIPT/VS is in line-I/O mode. Each time you see three asterisks, press Enter. These asterisks, which usually appear at the bottom of the screen, show that TSO is waiting for you to clear the screen before it can proceed.
If the Session Manager is installed and you selected the Session Manager mode option on the ISPF Settings panel, SCRIPT/VS and all PF and PA keys are under control of the Session Manager. When formatting is complete, you are prompted to enter a null line to return to ISPF control.

If the Session Manager is not called, the PA and function keys have their usual TSO-defined meanings; generally, the function keys are treated the same as Enter.
One or both of the panels listed may appear, depending on your treatment of the Style and Display Style Options fields. If both appear, they will be in this sequence:
1. Select SCRIPT/VS Formatting Style
2. SCRIPT/VS Options for Style
See Selecting a formatting style and Changing style options if you need information about using these panels. When you are finished with each panel, press Enter.
If SCRIPT/VS generated an output listing and you selected the Browse Output option, the output is displayed automatically in Browse mode. Otherwise, continue with the next step.
Note: If SCRIPT/VS formatting ends abnormally, ISPF displays a message in the upper-right corner of the screen and does not enter Browse mode. The list data set is retained, but the Foreground Print Options for Style panel (see step 11) is not displayed.

You can scroll the output up or down using the scroll commands. All the Browse commands are available to you. When you finish browsing the listing, enter the END command.
An optional print utility exit can be installed by your system programmer. If this exit is installed, it may cause SCRIPT/VS's response to differ from the descriptions here. See z/OS ISPF Planning and Customizing for more information about the print utility exit.
Another factor that can affect the performance of SCRIPT/VS is whether the TSO/E Information Center Facility is installed. If the TSO/E Information Center Facility is installed, your installation can optionally allow ISPF to display a panel for submitting the TSO/E Information Center Facility information with the print request. See Figure 1 for an example of this panel and Using the TSO/E information center facility for information about the fields on this panel.

If the TSO/E Information Center Facility is not installed, SCRIPT/VS displays the panel shown in Figure 1.

The Foreground Print Options for Style panel allows you to optionally print the formatted document and specify its disposition. On this panel, the Data Set Name field shows the name of the list data set that contains the SCRIPT/VS output. On the Command line, enter one of the options shown at the top of the panel.
Figure 1. Foreground Print Options for Style panel (ISRFP09P)
```
                  Foreground Print Options for Style:

   PK  Print data set and keep          K  Keep data set (without printing)
   PD  Print data set and delete        D  Delete data set (without printing)

   If END command is entered, data set is kept without printing.

 Data Set Name  :

 Print mode . . . BATCH              (Batch or Local)

 Batch SYSOUT class . .                
 Local Printer ID or
       writer-name. . .                    (For local printer)
 Local SYSOUT class . .                

 Job statement information:          (Required for system printer)
   ===>                                                                        
   ===>                                                                        
   ===>                                                                        
   ===>                                                                        
 Command ===>                                                                 
  F1=HELP      F2=          F3=END       F4=DATASETS  F5=FIND      F6=CHANGE
  F9=SWAP     F10=LEFT     F11=RIGHT    F12=SUBMIT
```
In the Print mode field, enter either of these commands:
- BATCH to submit your print request as a background job.
  If you choose BATCH, specify a valid Batch SYSOUT class and job statement information. Specifying BATCH causes SCRIPT/VS to ignore the "Local Printer ID or writer-name" field and the "Local SYSOUT class" field.
  SCRIPT/VS list data sets are formatted DCB=RECFM=VBM. Unless the line count is altered, the formatted page length may exceed the JES line count and cause duplicate page ejects. Therefore, specify this job statement information to prevent JES line counting:
```
/*JOBPARM LINECT=0
```
- LOCAL to print the output on a local printer.
  If you choose LOCAL, specify the "Local Printer ID or writer-name" of a local printer and optional "Local SYSOUT class". Specifying LOCAL causes SCRIPT/VS to ignore the "Batch SYSOUT class" field. Job statement information is ignored.
  
  Page spacing will probably vary from the expected format because of differences between 328x printers and 1403 or 3800 printers used as a formatting guide.
See Hardcopy utility (option 3.6) if you need information about the "Print mode", "Batch SYSOUT class", "Local Printer ID or writer-name", and "Local SYSOUT class" fields. For information about the "Job statement information" fields, see the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I.

When you press Enter, the SCRIPT/VS Processor panel is displayed again. A message indicating completion of the process is displayed in the upper-right corner of the screen.
You can perform one of these actions:
- Enter other parameters and call SCRIPT/VS again.
- Enter the END command to return to the Foreground Selection panel and select another processor.
- Enter the RETURN command to go to the ISPF Primary Option Menu.
- Use the jump function (=) to choose any primary option.