 |
» |
|
|
|
PASCAL | |
Compiles a compatibility mode Pascal/V program. Pascal/V is
not part of the HP 3000 Series 900 Computer System Fundamental Operating
Software and must be purchased separately. The native mode equivalent
of this command is PASXL. PASCAL [textfile] [,[uslfile] [,listfile]] [;INFO=quotedstring] - textfile
Actual file designator of the input file from which
the source program is read. This can be any ASCII input file. Formal
file designator is PASTEXT. Default is $STDIN. $STDIN is the current input device, usually your terminal. - uslfile
Actual file designator of the user subprogram library
(USL) file to which the object code is stored. This can be any binary
output file with a file code of USL or 1024. Its formal file designator is PASUSL. If the uslfile parameter is omitted, the object code is saved to
the temporary file $OLDPASS. If entered, this parameter indicates that the
USL file was created in one of four ways: By using the MPE/iX SAVE command to save the default USL file $OLDPASS, created during a previous compilation. By building the USL with the MPE segmenter -BUILDUSL command. Refer to the MPE Segmenter
Reference Manual. By creating a new USL file and specifying the MPE/iX BUILD command with a file code of USL or 1024. By specifying a nonexistent uslfile parameter, thereby creating a permanent file of the
correct size and type.
- listfile
Actual file designator of the file to which the
program listing is written. This can be any ASCII output file. Formal
file designator is PASLIST. Default is $STDLIST. $STDLIST is usually the terminal if you are running Pascal/V
interactively, or the printer if you are running a batch job. - quotedstring
A sequence of characters between two single quotation
marks (apostrophes) or between two double quotation marks. You may
use the delimiter as part of the string so long as the delimiter
appears twice. Any occurrence of two single or two double quotation
marks in a row is considered part of the string, and, therefore,
not the terminating delimiter. INFO=quotedstring is used in the Pascal programming language to pass initial
compiler options to a program. Pascal/V brackets the quotedstring with dollar signs and places it before the first
line of source code in the text file.
The PASCAL command compiles a compatibility mode Pascal/V
program and stores the object code in a user subprogram library
(USL) file on disk. If textfile is not specified, MPE/iX expects the source program
to be entered from your standard input device. If you do not specify listfile, MPE/iX sends the program listing to your standard
list device and identifies it by the formal file designator, PASLIST. The formal file designators used in this command (PASTEXT, PASUSL, and PASLIST) cannot be backreferenced as actual file designators
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. If you create the USL prior to compilation, you must specify
a file code of USL or 1024. If you omit the uslfile parameter, the object code is saved in the temporary
file domain as $OLDPASS. To keep it as a permanent file, you must save $OLDPASS under another name. This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. The following example compiles a Pascal/V program entered
from the standard input device and stores the object code in the
USL file $OLDPASS. The listing is then sent to the standard list
device. The next example compiles a Pascal/V program contained in
the disk file PASCSRC, and stores the object code in the USL file PASCOBJ. The program listing is stored in the disk file LISTFILE. PASCAL PASCSRC,PASCOBJ,LISTFILE |
- Commands
PASCALGO, PASCALPREP, PASXL, PASXLGO, PASXLLK PREP, RUN, LINK, LINKEDIT - Manuals
MPE Segmenter Reference Manual HP Pascal/iX Reference Manual
PASCALGO | |
Compiles, prepares, and executes a compatibility mode Pascal/V
program. Pascal/V is not part of the HP 3000 Series 900 Computer
System Fundamental Operating Software and must be purchased separately.
The native mode equivalent of this command is PASXLGO. PASCALGO [textfile] [,listfile] [;INFO=quotedstring] - textfile
Actual file designator of the input file from which
the source program is read. This can be any ASCII input file. Formal
file designator is PASTEXT. Default is $STDIN. $STDIN is the current input device, usually your terminal. PASTEXT cannot be backreferenced as an actual file designator
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. - listfile
Actual file designator of the file to which the
program listing is written. This can be any ASCII output file. Formal
file designator is PASLIST. Default is $STDLIST. $STDLIST is usually your terminal if you are running Pascal/V
interactively, or the printer if you are running a batch job. PASLIST cannot be backreferenced as an actual file designator
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. - quotedstring
A sequence of characters between two single quotation
marks (apostrophes) or between two double quotation marks. You may
use the delimiter as part of the string so long as the delimiter
appears twice. Any occurrence of two single or two double quotation
marks in a row is considered part of the string, and, therefore,
not the terminating delimiter. INFO=quotedstring is used in the Pascal/V programming language to pass
initial compiler options to a program. Pascal/V brackets the quotedstring with dollar signs and places it before the first
line of source code in the text file.
The PASCALGO command compiles, prepares, and executes a compatibility
mode Pascal/V program. If textfile is omitted, MPE/iX expects input from your standard
input device. If you do not specify listfile, MPE/iX sends the program listing to the formal file designator PASLIST (default is $STDLIST). The USL file created during the compilation is the system-defined
temporary file $OLDPASS, which is passed directly to the MPE segmenter.
It can only be accessed if you do not use the default for progfile. This is because the segmenter also uses $OLDPASS to store the prepared program segments, overwriting
any existing temporary file of the same name. This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. To compile, prepare, and execute a Pascal/V program entered
from your standard input device, with the program listing sent to
your standard list device, enter: To compile, prepare, and execute a Pascal/V program from the
disk file PASCSRC and send the program listing to the file LISTFILE, enter: PASCALGO PASCSRC,LISTFILE |
- Commands
PASCAL, PASCALPREP, PASXL, PASXLGO, PASXLLK PREP, RUN, LINK, LINKEDIT - Manuals
MPE Segmenter Reference Manual HP Pascal/iX Reference Manual
PASCALPREP | |
Compiles and prepares a compatibility mode Pascal/V program.
Pascal/V is not part of the HP 3000 Series 900 Computer System Fundamental
Operating Software and must be purchased separately. The native
mode equivalent of this command is PASXLLK. PASCALPREP [textfile] [,progfile] [,listfile] [;INFO=quotedstring] - textfile
Actual file designator of the input file from which
the source program is read. This can be any ASCII input file. Formal
file designator is PASTEXT. Default is $STDIN. $STDIN is the current input device, usually your terminal. PASTEXT cannot be backreferenced as an actual file designator
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. - progfile
Actual file designator of the program file to which
the prepared program segments are written. When progfile is omitted, the MPE segmenter creates the program
file, which is stored in the temporary file domain as $OLDPASS. If you do create your own program file, you must
do so in one of two ways: By using the MPE/iX BUILD command, and specifying a file code of 1029 or PROG, and a numextents value of 1. This file is then used by the PREP command. By specifying a nonexistent file in the progfile parameter, in which case a job/session temporary
file of the correct size and type is created.
- listfile
Actual file designator of the file to which the
program listing is written. This can be any ASCII output file. Formal
file designator is PASLIST. Default is $STDLIST. $STDLIST is usually your terminal if you are running Pascal/V
interactively, or the printer if you are running a batch job. PASLIST cannot be backreferenced as an actual file designator
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. - quotedstring
A sequence of characters between two single quotation
marks (apostrophes) or between two double quotation marks. You may
use the delimiter as part of the string so long as the delimiter
appears twice. Any occurrence of two single or two double quotation
marks in a row is considered part of the string, and, therefore,
not the terminating delimiter. INFO=quotedstring is used in the Pascal programming language to pass initial
compiler options to a program. Pascal/V brackets the quotedstring with dollar signs and places it before the first
line of source code in the text file.
The PASCALPREP command compiles and prepares a compatibility
mode Pascal/V program into a program file on disk. If you do not
specify textfile, MPE/iX expects input from the current input device.
If you do not specify listfile, MPE/iX sends the listing output to the formal file
designator PASLIST (default $STDLIST). The USL file $OLDPASS, created during compilation, is a temporary file
passed directly to the MPE segmenter. You may access it only if
you do not use the default for progfile. This is because the MPE segmenter also uses $OLDPASS to store the prepared program segments, overwriting
any existing temporary file of the same name. This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. The following example compiles and prepares a Pascal/V program
entered through your standard input device, and stores the prepared
program segments in the file $OLDPASS. The listing is printed on your standard list
device. To compile and prepare a Pascal/V source program from the
source file PASCSRC, store it in PASCPROG, and send the listing to your standard list device,
enter: PASCALPREP PASCSRC,PASCPROG |
- Commands
PASCALGO, PASCAL, PASXL, PASXLGO, PASXLLK PREP, RUN, LINK, LINKEDIT - Manuals
MPE Segmenter Reference Manual Pascal/3000 Reference Manual
PASSWORD | |
Creates or changes a user password. (Native Mode) This command may be issued from a session or in BREAK. It
is breakable (aborts execution). It cannot be used if $STDIN or
$STDLIST are redirected. This command allows users to establish or change their own
passwords. It may be issued interactively or programmatically within
a session and prompts the user for required input. Passwords are
not echoed (displayed) during input. PASSWORD
ENTER OLD USER PASSWORD:
ENTER NEW USER PASSWORD:
ENTER NEW USER PASSWORD AGAIN:
PASSWORD WAS CHANGED SUCCESSFULLY. |
The old user password is requested only if it exists. - Commands
LISTUSER, ALTUSER - Manuals
None
PASXL | |
Compiles an HP Pascal/iX program. HP Pascal/iX is not part
of the HP 3000 Series 900 Computer System Fundamental Operating
Software and must be purchased separately. (Native Mode) PASXL [textfile] [,[objectfile] [,[listfile] [,libfile]]] [;INFO=quotedstring] - textfile
The name of the text file that contains the source
code to be compiled. This is an ASCII file that you prepare with
an editor such as EDIT/V. The formal file designator is PASTEXT. If you are running HP Pascal/XL from your terminal, you will
probably specify a disk textfile. If you do not specify textfile, then the default file is $STDIN. $STDIN is the current input device, usually your terminal. When textfile is your terminal, you can enter source code interactively in
response to the > prompt. When you have entered all the source code, type
a colon (:) in response to the > prompt to end the interactive input. The source code to be compiled can be a program or a list
of modules. - objectfile
Actual file designator of the object file to which
the object code is stored. This file is stored in binary form and
has a file code of either (1461) or NMRL (1033). Its formal file designator is PASOBJ. If the objectfile parameter is omitted, the object code is saved to
the temporary file $OLDPASS. If you specify objectfile, the compiler stores the object file in a permanent
file of the correct size and type, and with the name you specified.
If a file of the same name already exists, the object code overwrites
that file. If the compiler issues an error message telling you that a
new or existing object file you are trying to compile to is too
small, build the object file with a larger size and recompile to
it. You may use the MPE/iX SAVE command to store $OLDPASS as a permanent file under another name. - listfile
The name of the file on which the compiler writes
the program listing. It can be any ASCII file. The default is $STDLIST. $STDLIST is usually the terminal if you are running HP
Pascal/iX interactively, or the printer if you are running a batch
job. The formal file designator is PASLIST. If your terminal is both textfile and listfile, the compiler does not write the program listing
on the terminal. If listfile is $NULL or a file other than $STDLIST, the compiler displays on $STDLIST those lines that contain errors. - libfile
The name of the HP Pascal/iX library file that the
compiler searches if a search path is not specified with the compiler
option SEARCH. The default is PASLIB in your group and account. - quotedstring
A string of no more than 132 characters (including
the single or double quotation marks that enclose it). The quotedstring string is used in the HP Pascal/iX programming language
to pass initial compiler options to the compiler. HP Pascal/iX brackets
the quotedstring string with dollar signs ($) and places the string before the first line of
source code in the text file.
| | | |  | NOTE: The formal file designators used in this command (PASTEXT, PASOBJ, PASLIST, and PASLIB) cannot be backreferenced as actual file designators
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. | | | | |
This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. The following example compiles an HP Pascal/iX program entered
from your standard input device and stores the object program in
the object file $OLDPASS. The listing is then sent to your standard list
device. The next example compiles an HP Pascal/iX program contained
in the disk file SOURCE and stores the object program in the object file OBJECT. The program listing is stored in the disk file LISTFILE. PASXL SOURCE,OBJECT,LISTFILE |
| | | | | NOTE: Program development in native mode uses the MPE/iX LINK command not the MPE V/E PREP command. This produces a significant change in
the method of linking code. | | | | |
If you have created a program called MAIN and a subprogram called SUB, each contained in a separate file, you might
choose to handle it this way in MPE V/E: PASCAL MAIN, SOMEUSL
PASCAL SUB, SOMEUSL
:
:
PREP SOMEUSL, SOMEPROG
:
RUN SOMEPROG |
The second command appends the code from SUB to SOMEUSL. However, LINK (in MPE/iX native mode) does not append SUB. In MPE/iX, you must compile the source files
into separate object files and then use the Link Editor to link
the two object files into the program file, as in this example: PASXL MAIN, OBJMAIN
PASXL SUB, OBJSUB
:
LINK FROM=OBJMAIN,OBJSUB;TO=SOMEPROG
:
RUN SOMEPROG |
However, if an NMRL is used instead of an NMOBJ, the above can be simplified to the following: BUILD RLFILE;DISC=10000;CODE=NMRL
PASXL MAIN, RLFILE
PASXL SUB, RLFILE
LINK RLFILE,SOMEPROG
RUN SOMEPROG |
- Commands
PASCALGO, PASCALPREP, PASCAL, PASXLGO, PASXLLK PREP, RUN, LINK, LINKEDIT - Manuals
HP Pascal/iX Reference Manual HP Link Editor/XL Reference Manual
PASXLGO | |
Compiles, links, and executes an HP Pascal/iX program. HP
Pascal/iX is not part of the HP 3000 Series 900 Computer System
Fundamental Operating Software and must be purchased separately.
(Native Mode) PASXLGO [textfile] [,[listfile] [,[libfile]]] [;INFO=quotedstring] - textfile
The name of the text file that contains the source
code to be compiled. This is an ASCII file that you prepare with
an editor such as EDIT/V. The formal file designator is PASTEXT. If you are running HP Pascal/iX from your terminal, you will
probably specify a disk textfile. If you do not specify textfile, then the default file is $STDIN. $STDIN is the current input device, usually your terminal. When textfile is your terminal, you can enter source code interactively in
response to the > prompt. When you have entered all the source code, type
a colon (:) in response to the > prompt to end the interactive input. The source code to be compiled can be a program or a list
of modules. - listfile
The name of the file on which the compiler writes
the program listing. It can be any ASCII file. The default is $STDLIST. $STDLIST is usually the terminal if you are running HP
Pascal/iX interactively, or the printer if you are running a batch
job. The formal file designator is PASLIST. If your terminal is both textfile and listfile, the compiler does not write the program listing
on the terminal. If listfile is $NULL or a file other than $STDLIST, the compiler displays on $STDLIST those lines that contain errors. - libfile
The name of the HP Pascal/iX library file that the
compiler searches if a search path is not specified with the compiler
option SEARCH. The default is PASLIB in your group and account. - quotedstring
A string of no more than 132 characters (including
the single or double quotation marks that enclose it). The quotedstring string is used in the HP Pascal/iX programming language
to pass initial compiler options to the compiler. HP Pascal/iX brackets
the quotedstring string with dollar signs ($) and places the string before the first line of
source code in the text file.
| | | | | NOTE: The formal file designators used in this command (PASTEXT, PASLIB, and PASLIST) cannot be backreferenced as actual file designators
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. | | | | |
This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. To compile, link, and execute an HP Pascal/iX program entered
from your standard input device, with the program listing sent to
your standard list device, enter: To compile, link, and execute an HP Pascal/iX program from
the disk file SOURCE and send the program listing to the file LISTFILE, enter: - Commands
PASCAL, PASCALGO, PASCALPREP, PASXL, PASXLLK PREP, RUN, LINK, LINKEDIT - Manual
HP Pascal/iX Reference Manual
PASXLLK | |
Compiles and links an HP Pascal/iX program. HP Pascal/iX is
not part of the HP 3000 Series 900 Computer System Fundamental Operating
Software and must be purchased separately. (Native Mode) PASXLLK [textfile] [,[progfile] [,[listfile] [,libfile]]] [;INFO=quotedstring] - textfile
The name of the text file that contains the source
code to be compiled. This is an ASCII file that you prepare with
an editor such as EDIT/V. The formal file designator is PASTEXT. If you are running HP Pascal/iX from your terminal, you will
probably specify a disk textfile. If you do not specify textfile, then the default file is $STDIN. $STDIN is the current input device, usually your terminal. When textfile is your terminal, you can enter source code interactively in
response to the > prompt. After you enter the source code, type
a colon (:) in response to the > prompt to end the interactive input. The source code to be compiled can be a program or a list
of modules. - progfile
The name of the program file on which the MPE/iX
linker writes the linked program. The default is $NEWPASS. - listfile
The name of the file on which the compiler writes
the program listing. It can be any ASCII file. The default is $STDLIST. $STDLIST is usually the terminal if you are running HP
Pascal/iX interactively, or the printer if you are running a batch
job. The formal file designator is PASLIST. If your terminal is both textfile and listfile, the compiler does not write the program listing
on the terminal. If listfile is $NULL or a file other than $STDLIST, the compiler displays those lines that contain
errors on $STDLIST. - libfile
The name of the HP Pascal/iX library file that the
compiler searches if a search path is not specified with the compiler
option SEARCH. The default is PASLIB in your group and account. - quotedstring
A string of no more than 132 characters (including
the single or double quotation marks that enclose it). The quotedstring is used to pass initial compiler options to the HP
Pascal/iX compiler. HP Pascal/iX brackets the quotedstring with dollar signs ($) and places the string before the first line of
source code in the text file.
| | | | | NOTE: The formal file designators used in this command (PASTEXT, PASLIB, and PASLIST) cannot be backreferenced as actual file designators
in the command parameter list. For further information, refer to
the "Implicit FILE Commands for Subsystems" discussion of the FILE command. | | | | |
This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. The following example compiles and links an HP Pascal/iX program
entered through your standard input device and stores the linked
program in the file $OLDPASS. The listing will be printed on your standard
list device. To compile and link an HP Pascal/iX source program from the
source file SOURCE, store it in PROG, and send the listing to your standard list device,
enter: - Commands
PASCAL, PASCALGO, PASCALPREP, PASXL, PASXLGO, PREP, RUN, LINK, LINKEDIT - Manuals
HP Pascal/iX Reference Manual HP Pascal/iX Programmer's Guide HP Link Editor/XL Reference Manual
PAUSE | |
The PAUSE command allows the current task to be suspended
or "sleep" for a specifiec number of seconds.) | | | | | NOTE: This command follows the optional MPE/iX command line
syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning
of this chapter. | | | | |
PAUSE [num_seconds]
[[ ;JOB= ]jobid]
[ [;INTERVAL=] interval_secs]
[ ;EXIST | WAIT | NOTEXIST] Collectively EXIST, WAIT and NOTEXIST are referred to as the "while_state", since PAUSE sleeps "while" the specified state is true. - num_seconds
If num_seconds is specified without jobid PAUSE sleeps for that many seconds, or until the process
issuing the pause is interrupted by the break signal. If "jobid"
is also supplied then "num_seconds" has a different meaning. In
this case it indicates the maximum duration for the PAUSE command,
such that PAUSE should continue while the selected jobs are in their
"while_state" or when num_seconds has expired, whichever is shortest. Thus, num_seconds represents the maximum length of the pause. If PAUSE completes but one or more jobs are still in their "while state"
a CIWARN is reported. - jobid
can be one of: [#]Jnnn, [#]Snnn, [ jobname,]user.acct, @, @J, @S. Note if jobname is included than the jobid must be quoted since the comma is a command token
delimiter. If the JOB= parameter is specified then PAUSE sleeps while jobid is in its "while_state". jobid can be an executing, waiting, scheduled job, or a session. jobid can also name many jobs or sessions. Wildcarding
is supported, and a non-wildcarded [jname,]user.acct can match several jobs or sessions. The job name
value can be " ," or " @," to match all jobs or sessions without
a job name. When more than one job or session matches jobid PAUSE sleeps while all matching jobs are in their "while_state".
If the job executing PAUSE matches jobid it will not be selected. - interval_secs
If interval_secs is specified PAUSE sleeps for this many seconds between attempts to see
if jobid is still in its "while_state". Otherwise, PAUSE sleeps a variable amount of seconds depending on the
job state and the number of previous times a particular job has
been polled. This computed method favors executing jobs that terminate
quickly. - EXIST
(default) means to pause while all jobs and sessions
matching "jobid" exist. These jobs can be scheduled, waiting, executing,
etc., but as long as the SHOWJOB command displays one or more of
the jobs defined by "jobid", the pause continues - WAIT
means to pause while the selected job or jobs are
waiting. As soon as all the matching jobs are no longer waiting
(meaning all the job states are no longer "introduced", "waiting",
or "scheduled") the pause ends. The life cycle of a job is typically:
[sched or waiting->] intro-> initializing-> exec-> [susp-> exec->]
terminate. Waiting jobs are considered all job states left of and
excluding "initializing". Non-waiting jobs are all jobs right of
and including "initializing" - NOTEXIST
means to pause while the matching job or jobs do
not exist. As soon as any jobs matching "jobid" exist (in any state)
the pause completes. PAUSE might miss finding jobs that log off
quickly. This is particularly true for a match on a single job/session
number. A more practical use might be: PAUSE job=@J;notexistwhich
means to sleep while no jobs exist. As soon as the first job is streamed
the above pause stops.
The value of this command lies in providing a way to suspend
one activity while another process waits for a specific condition
to exist, for example, forcing a job to "idle" while waiting for
the creation of a key file or the setting of a crucial flag. You
may use several MPE/iX commands to query user or system variables,
or the system itself, in order to verify the existence of the desired
condition. In its simpliest form, the PAUSE command sleeps for "num_seconds",
or less if BREAK is pressed. In this simple case no "jobid" is specified
and all other command arguments are ignored. If the "jobid" parameter
is specified then "interval_secs" and the remaining command parameters
are relevant. When "jobid" is supplied PAUSE typically sleeps until the
jobs or sessions matching "jobid" have terminated. This command is available from a program or in BREAK. You
can execute BREAK while PAUSE is active. BREAK terminates the pause. If a job must read data from a file called LOGDAT.GXK.PROCCTRL, which is to be created by a session, then the
job may suspend activity pending a test for the existence of the
vital file. The example below shows how the PAUSE command can be used to synchronize a session to some
job activity via the existence of a known file: STREAM JLOGEND
#J123
...
...
SETVAR START_CPU HPCPUSECS
WHILE NOT FINFO("LOGDAT.GXK.PROCCTRL","EXISTS") AND &
HPCPUSECS-START_CPU <5 DO
PAUSE 2
ENDWHILE
DELETEVAR START_CPU |
| | | | | NOTE: The CPU seconds used by the WHILE loop is not allowed to exceed 5 seconds. | | | | |
If the file does not exist and the WHILE loop has consumed
less than five CPU seconds, then the job pauses for two seconds.
This pause does not use CPU-time. The CPU check is included to prevent
an infinite loop that may result if JLOGEND aborted unexpectedly and thus did not get a chance
to build the LOGDAT file. The following example pauses while job #J24 exists in the
system job table, (JMAT) i.e., it is visible in SHOWJOB output. The next example sleeps as long as MANGER.SYS has
any jobs or sessions running or waiting. :PAUSE job=manager.sys; exists |
The next example pauses until the job just streamed
starts executing. :STREAM myjob:PAUSE job=!hplastjob; wait |
Or, sleeps until the job you just streamed completes. The following example sleeps until all jobs have
logged off or 5 minutes, whichever occurs first. :PAUSE 300, @J:IF hpcierr = -9032 then |
# pause terminated but one or more
jobs are still runningThe next example pauses while all jobs (by
naming convention only) in the PROD account are running. # note the quotes are requiredThe
next example sleeps while the backup job ("JBACKUP,OP.SYS") has
not been streamed. PAUSE reports CIWARN 9032 if the job is not streamed within
30 minutes. :PAUSE 1800, job="jbackup,op.sys"; notexist |
The final example polls the system job table every
3 minutes looking for any job or session matching a user name that
includes the letters "MGR", and waits for all such job/sessions to
terminate before the pause ends. - Commands
WHILE, INPUT, SHOWJOB - Manuals
None
PLISTF (UDC) | |
The PLISTF UDC executes the LISTFILE command to list descriptions of one or more disk files. System-defined UDCs are not automatically available. Your
System Manager must use the SETCATALOG command to make these UDCs available for your
use. For example: SETCATALOG HPPXUDC.PUB.SYS;SYSTEM;APPEND |
PLISTF [fileset] [,format_opt] [;outfile] The following parameters are supported with the PLISTF UDC. Refer to the LISTFILE command for a complete explanation of the parameters
used with the PLISTF UDC. - fileset
Specifies a set of files to be listed, including
MPE and HFS files. If fileset is not specified, the default is @. - format_opt
An output format option. If this parameter is omitted,
the default is FORMAT=0, which shows only the file names. The format option
must be specified as a numeric value. Format names (for example, QUALIFY) are not supported by this UDC. Refer to the LISTFILE command for a complete description of each available
format option. - outfile
The name of the output file. If this parameter is
omitted, the output is displayed to $STDLIST. The outfile supports both MPE and HFS syntax. The outfile cannot be $NEWPASS.
The PLISTF UDC lists descriptions of one or more disk files
at the level of detail you select. The UDC executes the following
form of the LISTFILE command: LISTFILE fileset ,format_opt [>outfile] This UDC may be issued from a session, a job, a program, or
in break mode. Pressing Break aborts execution. If a permanent file exists with the same name as specified
as outfile, then CIOR defaults are used rather than the PLISTF CCTL default. Refer to the LISTFILE command earlier in this chapter for examples. - Commands
LISTF, LISTFILE, LISTDIR (UDC), FINDFILE (UDC), FINDDIR (UDC) - Manuals
None
PREP | |
Prepares a compatibility mode program from a user subprogram
library (USL) file onto a program file. [;ZERODB][;CAP=capabilitylist] [;PMAP] |
[;RL=filename] [;MAXDATA=segsize] [;PATCH=patchsize] |
[;STACK=stacksize] [;DL=dlsize] |
[;NOSYM] [{;FPMAP | ;NOFPMAP}] |
- uslfile
Actual file designator of user subprogram library
(USL) file into which the program has been compiled. - progfile
Actual file designator of program file onto which
prepared program segments are written. This can be any binary output
file created in one of two ways: By using the MPE/iX BUILD command to create a new file and specifying a
file code of PROG or 1029, and one extent. By specifying a nonexistent file in the progfile parameter, in which case a file of the correct size
and type is created. This file is a temporary file.
- ZERODB
Request to initialize to zero the initially defined,
user-managed (DL-DB) area of the stack, as well as the uninitialized
portions of the DB-Q (initial). Default is that these areas are
not affected. - PMAP
Request to produce a descriptive listing of the
prepared program to a file whose formal file designator is $SEGLIST. If no FILE command is found referencing $SEGLIST, the listing is produced on $STDLIST. Default is no listing. - segsize
Maximum permitted stack area (Z-DL) in words. This
parameter should be included when it is expected that the size of
DL-DB or Z-DB areas will be changed during program preparation or
execution. Regardless of what you specify, MPE/iX may change the segsize to accommodate table overflow conditions. If you prepare your program with segsize less than the configured minimum, the value is rounded
up to the minimum or the amount needed by the program (as calculated
by the MPE segmenter). The maximum actual segsize permitted a program is 31,232 words. You may prepare your
program with a segsize larger than necessary so long as this maximum is
not exceeded. If the specified segsize does exceed the maximum, it is rounded down to 31,232
words. - stacksize
Size of initial local data area (Z-Q initial) stack,
in words. This value, if specified, must be between 511 and 32767
words. This parameter overrides the default stacksize estimated by the MPE segmenter. - dlsize
DL-DB area to be initially assigned to stack. This
area is of interest mainly in programmatic applications. Due to
system logging considerations, the DL-DB area is always rounded
upward so that the distance from the beginning of the stack data
segment to the DB-address is a multiple of 128 words. Specify a
value between -1 and 32767 words. The default is estimated by the
MPE segmenter. - capabilitylist
Capability class attributes associated with a program,
specified as two-character mnemonics. If more than one mnemonic
is specified, each must be separated from its neighbor by a comma.
The mnemonics are: IA = Interactive Access
BA = Local Batch Access
PH = Process Handling
DS = Extra Data Segments
MR = Multiple RINs
PM = Privileged Mode |
You can only specify those capabilities assigned by the account
manager or system manager. Default is IA and BA. - filename
Actual file designator of the relocatable library
(RL) file to be searched to satisfy external references during preparation.
This can be any permanent binary file of type RL. It need not belong
to your logon group, nor have a reserved local name. This file,
to which you must have READ and LOCK access, yields a single segment
that is incorporated into the segments of the program file. For
more information, refer to the MPE Segmenter Reference
Manual (30000-90011). Default is that no library is
searched. - patchsize
Specifies the size of the patch area. This size
applies to all segments within the program file. The value you specify
must be within -1 and 16380 words. - NOSYM
Suppresses the symbolic DEBUG option. Refer to the HPToolset/V Reference Manual (32350-90001). - FPMAP or NOFPMAP
Includes or excludes the internal PMAP information. FPMAP is a request to have internal PMAP information
included in the program. NOFPMAP excludes PMAP information from the program when
the system FPMAP or job/session FPMAP is on. If the symbolic DEBUG option is invoked, default is FPMAP. Otherwise the default is NOFPMAP.
This command may be issued from a session, job, or program.
It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. In the following example, you use the PREP command to prepare a program from the USL file USLX and the MPE segmenter stores it in the program
file PROGX. Since the MPE segmenter creates PROGX for you, it is a temporary file, and you must
subsequently save it in the permanent file domain. PREP USLX,PROGX
SAVE PROGX |
Although you will get the best results by having the MPE segmenter
create the program file for you, you can also use the BUILD command to create your own permanent program file.
When you do so, be sure to specify a file code of PROG or 1029 and a numextents parameter value of 1, as shown below: BUILD PROGX;CODE=PROG;DISC=,1
PREP USLX,PROGX |
To prepare a program from the USL file named USLZ and store it in a program file named PROGZ, list the prepared program, assign a stacksize of 511 words, and limit access to PROGZ to those users having IA, BA, PH, and DS capability
enter: PREP USLZ,PROGZ;PMAP;STACK=511;CAP=IA,BA,PH,DS |
- Commands
PREPRUN, RUN - Manuals
MPE Segmenter Reference Manual
PREPRUN | |
Prepares and executes a compiled compatibility mode program. PREPRUN uslfile[,entrypoint] |
[;NOPRIV] [;PMAP] [;NOCB] [;DEBUG] [;INFO=quotedstring] |
[;LMAP[;STDIN [{*formaldesig =fileref $NULL}]]] |
[;MAXDATA=segsize] [;PARM=parameternum] [;STDLIST=[ { *formaldesig fileref[ ,NEW] $NULL }]] |
[;STACK=stacksize][ ;DL=dlsize] [;PATCH=patchsize] |
[;NOSYM] [{;FPMAP | ;NOFPMAP}] [;CAP=capabilitylist] |
- uslfile
Actual file designator of the USL file to which
the program has been compiled. - entrypoint
Contains a character string, terminated by a blank,
specifying the entry point (label) in the program where execution
is to begin when the program is executed. The entrypoint parameter may be the primary entry point or any secondary
entry point in the program's outer block. Default is primary entry
point. - NOPRIV
Declaration that the program segments are to be
placed in nonprivileged (user) mode. This parameter is for programs
prepared with privileged mode (PM) capability and makes them accessible
to nonprivileged users. Normally, program segments containing privileged
instructions are executed in privileged mode only if the program
was prepared with privileged mode capability class. (A program containing
legally compiled privileged code, placed in nonprivileged mode,
may abort when an attempt is made to execute it.) If NOPRIV is specified, all segments are placed in nonprivileged
mode. (Library segments are not affected because their mode is determined
independently.) Default is that segments of a privileged mode program
remain in privileged mode. - PMAP
Request to produce a descriptive listing of the
prepared program to a file whose formal file designator is $SEGLIST. If $SEGLIST is not found in a FILE command, the listing is produced on the current
list device. Default is no listing. - DEBUG
Request to issue a DEBUG call before the first executable instruction of
the program. Unless the user has READ and EXECUTE access to the
program file, this parameter is ignored. If privileged mode (PM)
capability has been assigned, the user is put into privileged mode
debug. If not, the user is put into user mode debug. Default is
that the DEBUG call is not issued. - LMAP
Request to produce a descriptive listing of the
allocated (loaded) program to a file whose formal file designator
is LOADLIST. If no FILE command referencing LOADLIST is found, the listing is produced on $STDLIST. Default is no listing. - ZERODB
Request to initialize to zero the initially defined
user-managed (DL-DB) area and uninitialized portions of the DB-Q
(initial) area. Default is that these areas are not affected. - segsize
Maximum permitted stack area (Z-DL) in words. This
parameter should be included when you expect that the size of DL-DB
or Z-DB areas will be changed during program preparation or execution.
Regardless of what you specify, MPE/iX may change the segsize to accommodate table overflow conditions. If you prepare your program with a segsize less than the configured minimum, the value is rounded
up to the minimum or the amount needed by the program (as calculated
by the MPE segmenter). The maximum actual segsize permitted a program is 31,232 words. You may prepare your
program with a segsize larger than necessary so long as this maximum is
not exceeded. If the specified segsize does exceed the maximum, it will be rounded down
to 31,232 words. - parameternum
An integer containing a parameter to be passed to
the new program (accessed through Q-4 of the outer block). - stacksize
Size of local data area, Z-Q (initial), in the stack,
in words. If it is specified, this value must be between 511 and
32,767 words. The default is estimated by the MPE segmenter. - dlsize
DL-DB area to be initially assigned to stack. Due
to system logging considerations, the DL-DB area is always rounded
upward, so that the distance from the beginning of the stack data
segment to the DB-address is a multiple of 128 words. The value
you specify must be between -1 and 32,767 words. The default is
estimated by the MPE segmenter.
- G, P, or S
Searches the segmented procedure libraries of the
program file's group and account. The G option searches the group library, the account
library, and then the system library. The P option searches the account library then the system
library. The S option searches the system library for external
references to segmented procedures. Default is S. - capabilitylist
Capability class attributes associated with the
program, specified in two-character mnemonics. If more than one
mnemonic is specified, each must be separated from its neighbor
by a comma. The mnemonics are: IA = Interactive Access
BA = Local Batch Access
PH = Process Handling
DS = Extra Data Segments
MR = Multiple RINs
PM = Privileged Mode |
You can specify only those attributes that you possess through
assignment by the account manager or the system manager. Default
is IA and BA. - filename
Actual file designator of the relocatable library
(RL) file to be searched to satisfy external references during preparation
of the program. This can be any permanent file of type RL, to which
you must have READ and LOCK access. It need not belong to the logon
group, nor does it require a reserved, local name. This file yields
a single segment that is incorporated into the segments of the program
file. Refer to the MPE Segmenter Reference Manual (30000-90011)
for a description of RL files. Default is that no library is searched. - NOCB
Request that the file system not use stack segment
(PCBX) for its control blocks, even if sufficient space
is available. This permits you to expand your stack (with the DLSIZE or ZSIZE intrinsics) to the maximum possible limit at a
later time. It does, however, cause the file management system to operate
more slowly for this program. - quotedstring
A sequence of characters between two single quotation
marks (apostrophes) or two double quotation marks. You may use the
delimiting character as part of the string so long as the delimiter
appears twice. Any occurrence of two single quotation marks, or
two double quotation marks in a row, is considered part of the string,
and, therefore, no
|
