HP 3000 Manuals

Redirecting SYSGEN Input and Output [ System Startup, Configuration, and Shutdown Reference Manual ] MPE/iX 5.0 Documentation


System Startup, Configuration, and Shutdown Reference Manual

Redirecting SYSGEN Input and Output 

By using SYSGEN's file designators, you can redirect SYSGEN's input and
output.  Redirecting SYSGEN's input and output enables you, for example,
to issue commands to SYSGEN using command files that can operate without
user intervention or interactive keyboard input.

SYSGEN uses three formal file designators for input, output, and listing:

   *   SYSGIN. The formal file designator for the standard SYSGEN input
       file.  By default, this file is set to $STDINX.

   *   SYSGOUT. The formal file designator for the standard SYSGEN output
       file.  By default, this file is set to $STDLIST.

   *   SYSGLIST. The formal file designator for the standard SYSGEN
       listing file.  By default, this file is set to any device in the
       class LP.

$STDINX and $STDLIST are the file names for the terminal from which
SYSGEN is run.  The device in class LP is your system printer.

Redirect SYSGEN input and output by using the FILE command and equating
some other files to SYSGIN, SYSGOUT, and SYSGLIST, or by using the INFO
parameter and options in the SYSGEN command line.

For example, the commands FILE SYSGIN=NEWIN and SYSGEN,,NEWIN accomplish
the same task.  When SYSGEN is activated, they utilize NEWIN as the input
file.  Likewise, the commands FILE SYSGOUT=NEWOUT and SYSGEN,,,NEWOUT
equate NEWOUT to the formal file designator, SYSGOUT, so SYSGEN utilizes
NEWOUT as the output file.

With redirection you can use a command input file to complete common
routines that you perform frequently.  Example 4-9 lists a three-line job
stream (named SYSGENON) which, when run using the STREAM command, logs on
to the system, enters SYSGEN, and executes the SYSGEN command file
(LISTIT) in example 4-10.

Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-90003
and 32650-90364) for information on the STREAM command.
____________________________________________________________________
|                                                                  |
|                                                                  |
|      1     !JOB SYSGENON,MANAGER/userpass.SYS/acctpass,groupname |
|      2     !SYSGEN,,LISTIT                                       |
|      3     !EOJ                                                  |
|                                                                  |
____________________________________________________________________

          Example 4-9.  Command File (SYSGENON) Created With EDITOR 

Table 4-2 explains the actions performed by each line of the preceding
command file.

          Table 4-2.  Actions Performed by Command File Example 

--------------------------------------------------------------------------------------------
|         |                                                                                |
|  Line   |                                     Action                                     |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 1       | Log on to the file SYSGENON as MANAGER.SYS with all accompanying system        |
|         | manager capabilities.                                                          |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 2       | Activate SYSGEN and redirect input so that SYSGEN uses the file named LISTIT   |
|         | as the input file.                                                             |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 3       | End the job file after SYSGEN has completed the tasks outlined by the SYSGEN   |
|         | command file LISTIT.                                                           |
|         |                                                                                |
--------------------------------------------------------------------------------------------

Example 4-10 lists the contents of the command file (LISTIT), which, when
run, prints SYSGEN information on the system printer.
_______________________________________
|                                     |
|                                     |
|      1     PERMYES ON               |
|      2     IO                       |
|      3     LDEV DEST=OFFLINE        |
|      4     LPATH DEST=OFFLINE       |
|      5     LCLASS DEST=OFFLINE      |
|      6     OCLOSE                   |
|      7     EXIT                     |
|      8     EXIT                     |
|                                     |
_______________________________________

          Example 4-10.  SYSGEN Command File (LISTIT) 

Table 4-3 explains the actions performed by the lines of the command file
example.

          Table 4-3.  Actions Performed by Command File LISTIT 

--------------------------------------------------------------------------------------------
|         |                                                                                |
|  Line   |                                     Action                                     |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 1       | Set PERMYES ON. Recommended for all command files.                             |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 2       | Activate the IO configurator.                                                  |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 3       | Send the characteristics of configured I/O devices to the listing file         |
|         | SYSGLIST.                                                                      |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 4       | Send the characteristics of configured I/O paths to the listing file.          |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 5       | Send the class name, class mode, and devices associated with each class to the |
|         | listing file.                                                                  |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 6       | Close (print) the listing file.                                                |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 7       | Exit the IO configurator.                                                      |
|         |                                                                                |
--------------------------------------------------------------------------------------------
|         |                                                                                |
| 8       | Exit SYSGEN.                                                                   |
|         |                                                                                |
--------------------------------------------------------------------------------------------

When using SYSGEN in a noninteractive mode (such as a batch job or a
command file), certain conditions may occur that cause SYSGEN to ask for
confirmation.  For example, if a KEEP is attempted on top of an already
existing configuration group, SYSGEN asks for confirmation.  If no
configuration exists, no questions are asked.

When you set up the input to SYSGEN you may not know if the question will
be asked.  To ensure the operation's success, set PERMYES ON at the
beginning of any set of noninteractive commands as shown in step 1 above.



MPE/iX 5.0 Documentation