MPE/iX Commands Reference Manual HP 3000 MPE/iX Computer Systems Edition 10 32650-90864 E1098 Printed in: U.S.A.
Notice The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability or fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for direct, indirect, special, incidental or consequential damages in connection with the furnishing or use of this material.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 1. Commands by Task Task-Related Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2. Command Definitions A-B Commands and Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Native Mode Command Structure. . . . . . . . . .
COB74XLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146 COB85XL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149 COB85XLG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153 COB85XLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FREERIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FTN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FTNGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FTNPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Command Definitions P-R PASCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .414 PASCALGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .416 PASCALPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .418 PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . . . .
SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SETCATALOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SETCLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SETCOUNTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VSRESERVESYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .700 VSTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .701 VSUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .710 WARN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restricted Rights Legend 2 Table 2-1. Parm= values for the CI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Table 2-2. Default Parameters for the ALTACCT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Table 2-3. Default Values for the ALTGROUP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Table 2-4. Default Values for the ALTUSER Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface The ninth edition of the MPE/iX Commands Reference Manual is one volume with command descriptions alphabetically from A through X. This manual is written for all users of the HP 3000 MPE/iX Computers. MPE/iX, Multiprogramming Executive with Integrated POSIX, is the latest in a series of forward-compatible operating systems for the HP 3000 line of computers. In HP documentation and in talking with HP 3000 users, you will encounter references to MPE XL, the direct predecessor of MPE/iX.
COMMAND {ON | OFF} [] In a syntax statement, brackets enclose optional elements. In the following example, OPTION can be omitted: COMMAND filename [OPTION] When several elements are enclosed within brackets, you canm select one or none of the elements. In following example, you can select OPTION or parameter or neither. The elements cannot be repeated. COMMAND filename [OPTION | parameter] [ ...
Commands by Task 1 Commands by Task Commands are used to communicate with the MPE/iX operating system. They request MPE/iX to perform a specific task or provide specific information.
Commands by Task Task-Related Commands Task-Related Commands This chapter is an introduction to MPE/iX commands and their functions, categorized by the task they perform. The categories of tasks identified for MPE/iX commands are: • Accessing Subsystems and Utilities. • Command Interpreter Programming Tools. • Communicating with Other Users. • Executing User Programs. • Managing Accounts, Groups, and Users. • Managing Devices. • Managing Files. • Managing Jobs and Sessions. • Managing Spooler Operations.
Commands by Task Task-Related Commands Check that list to find an appropriate functional description, which in this case is "Creates a new account". Then check the lefthand column for the name of the command that performs that function, which in this case is NEWACCT. When you have located the command that most closely performs the task you want to accomplish, turn to chapter 2 of this manual for complete information about the syntax, parameters, operation, use, and examples for that command.
Commands by Task Task-Related Commands RETURN Causes execution to return from the current user command (UDC or command file) to the calling environment SETVAR Creates or modifies a CI variable. WHILE Used to control execution in a job, session, UDC, or command file. Communicating with Other Users TELL Sends a message to another active session. TELLOP Sends a message to the system console. WARN Sends an urgent message to jobs/sessions. WELCOME Used to create the system welcome message.
Commands by Task Task-Related Commands PURGEUSER Removes a user from an account. REPORT Displays accounting information about the logon account and group. Managing Devices ABORTIO =ABORTIO Aborts a single pending I/O request for a device. ASSOCIATE Gives a user operator control of a device. DEVCNTRL Script that ejects a tape an/or sets a tape device online. DISASSOCIATE Removes control of a device from a user. DOWN Removes a device from normal system use.
Commands by Task Task-Related Commands LISTFILE Lists file information using native mode scanning/parsing that can be easily expanded. LISTFTEMP Displays information about temporary files. NEWDIR Creates a directory NEWLINK Creates a symbolic link PRINT Prints the contents of a file. PURGE Deletes a file from the system. PURGEDIR Deletes a directory. PURGELINK Deletes a symbolic link, empty directory, or a regular file. RELEASE Removes all security provisions for a file.
Commands by Task Task-Related Commands HELLO Initiates an interactive session. JOB Defines a job to be activated in conjunction with the STREAM command to run in batch mode. JOBFENCE Defines the minimum input priority a job or session must have in order to execute. JOBPRI Sets or changes the default and/or maximum execution priority for batch jobs. JOBSECURITY Designates what level of user may request resources and control the execution of jobs.
Commands by Task Task-Related Commands Defines the minimum priority an output spoolfile needs in order to be printed. OUTFENCE RESUMESPOOL Resumes suspended spooler output to a spooled device. STARTSPOOL Initiates the spooler process for a device. SHUTQ Closes the spool queue for a specified logical device or device class. SPOOLER Controls spooler processes. SPOOLF Allows a qualified user to alter, print, or delete output spoolfiles.
Commands by Task Task-Related Commands SHOWQ Displays process scheduling data and the contents of each subqueue. =SHUTDOWN Initiates a shutdown of MPE/iX. TUNE Alters the dispatcher subqueues which determine when processes must relinquish the CPU. Managing User/System Logging ALTLOG Alters the attributes of an existing user logging identifier. CHANGELOG Changes the user logging file without stopping or interrupting the logging process. GETLOG Establishes a logging identifier on the system.
Commands by Task Task-Related Commands LDISMOUNT Causes a volume set that was reserved system-wide by the user to be released. LMOUNT Reserves a volume set system-wide. MOUNT Reserves an online volume set. VMOUNT Enables/disables the MPE/iX movable volume facility. VOLTIL Defragment diskspace, general user volume management VSCLOSE Closes a specified volume set and takes it offline. VSOPEN Reopens a volume set closed with VSCLOSE.
Commands by Task Task-Related Commands BBASICOMP Compiles an HP Business BASIC/V program in compatibility mode. BBASICPREP Compiles and prepares an HP Business BASIC/V program in compatibility mode. BBXL Initiates execution of the HP Business BASIC/XL interpreter. BBXLCOMP Compiles an HP Business BASIC/XL program. BBXLGO Compiles, links, and executes an HP Business BASIC/XL program. BBXLLK Compiles and links an HP Business BASIC/XL program. CCXL Compiles an HP C/iX program.
Commands by Task Task-Related Commands FTNXL Compiles an HP FORTRAN 77/iX program. FTNXLGO Compiles, links, and executes an HP FORTRAN 77/iX program. FTNXLLK Compiles and links an HP FORTRAN 77/iX program. PASCAL Compiles a compatibility mode Pascal/V program. PASCALGO Compiles, prepares, and executes a compatibility mode Pascal/V program. PASCALPREP Compiles and prepares a compatibility mode Pascal/V program. PASXL Compiles an HP Pascal/iX program.
Command Definitions A-B 2 Command Definitions A-B This chapter provides information on MPE/iX commands. For your convenience, they are arranged in alphabetical order. Each command specification contains the following information: Command Name Provides the command name at the top of each page followed by a brief definition of its function. Syntax Provides information in diagram format defining how to enter the command and its parameters.
Command Definitions A-B 26 Chapter 2
Command Definitions A-B Commands and Parameters Commands and Parameters MPE/iX commands tell the computer to perform a specific function. The parameters you enter for each command tell the computer to perform the function in a specific way. MPE/iX uses four classifications of parameters: • Required parameters. • Optional parameters. • Keyword parameters. • Positional parameters. These four classifications of parameters are briefly defined below.
Command Definitions A-B Commands and Parameters Positional Parameters The meaning of a positional parameter depends upon its position (location) in the parameter list. In the syntax diagrams for each command in this chapter, positional parameters are separated from each other by a comma (,). If you omit a positional parameter from the list, you must provide the comma placeholder that would normally precede that parameter.
Command Definitions A-B Commands and Parameters Chapter 2 29
Command Definitions A-B Native Mode Command Structure Native Mode Command Structure Many commands in this chapter have the designation Native Mode at the end of their definition. This means that the command is parsed by the Native Mode Command Parser. If Native Mode is not specified, the command is parsed by the Compatibility Mode Command Parser. (A command parser separates command parameters.) There is no relationship between the parser a command uses and the function(s) the command performs.
Command Definitions A-B Native Mode Command Structure Combining Positional/Keyword Parameters Another option is to enter NM-parsed commands by using a combination of positional and keyword specifications, for example: COMMAND A,B;KEYWORD3=C There is one important rule to remember when you combine positional and keyword parameters: once you specify a keyword parameter, you may no use positional parameters.
Command Definitions A-B Native Mode Command Structure Or, because decimal is the default you could omit the # sign and enter: SPOOLER DEV=0006;SUSPEND;SHOW Or, omitting the leading zeroes you could enter: SPOOLER DEV=6;SUSPEND;SHOW When entering numbers as command parameters, it is advisable to omit leading zeros for some commands parsed by the compatibility mode (CM) parser. Using Quotes and Strings The NM parser optionally accepts any string input in single or double quotes.
Command Definitions A-B Native Mode Command Structure String Processing MPE/iX string processing finds the first double or single quote and pairs it with the last quote of the same type to form a string. In other words, single quotes pair only with other single quotes and double quotes only with other double quotes. For this reason you can use single quotes within double quotes, and double quotes within single quotes. For example, all three of the following INFO strings are correct: ...
Command Definitions A-B Native Mode Command Structure • The SETVAR command. • The XEQ command. These three exceptions allow the use of only specific delimiters when specifying parameters, as defined below. Also the ECHO command accepts all delimiters and treats them as part of the value to be echoed Invoking User Defined Commands User defined commands may be structured to accept the KEYWORD=parm format, and you may mix keyword and positional parameters.
Command Definitions A-B Native Mode Command Structure NOTE If a parameter value begins with a quote it must have a matching end quote. If it does not begin with a quote it may contain embedded quotes which will be treated as any other character. For more information on the use of quotes, refer to the section "Using Quotes and Strings" earlier in this chapter.
Command Definitions A-B Remote Sessions and Command Intrinsics Remote Sessions and Command Intrinsics When used to invoke commands on remote systems the COMMAND or HPCICOMMAND intrinsics do not return a meaningful status code. For more information on calling intrinsics refer to the MPE/iX Intrinsics Reference Manual.
Command Definitions A-B Running the CI as a Program Running the CI as a Program The MPE/iX Command Interpreter (CI) is a Native Mode Program. You can run it the way you would any other program, either by explicitly using the RUN command (the first example below), or by using the the implied RUN (the second example): RUN CI.PUB.SYS CI In the first case, the RUN command controls execution of the CI. For more information, refer to the RUN command in this chapter.
Command Definitions A-B ABORT ABORT Aborts the current program or operation suspended by BREAK. (Native Mode) Syntax ABORT Parameters None. Operation Notes The ABORT command terminates a process that has been suspended by pressing the Break key. Programs do not terminate while critical system code is executing on their behalf, but terminate immediately following execution of that code. The ABORT command is available only from a session and only during BREAK, but it does not disrupt the session.
Command Definitions A-B ABORTIO/ =ABORTIO ABORTIO/ =ABORTIO Aborts a single pending I/O request for a device. Syntax ABORTIO ldev =ABORTIO ldev Parameters ldev The logical device number of the device for which you intend to abort one pending I/O request. Operation Notes This command aborts a single pending I/O request for the specified ldev.
Command Definitions A-B ABORTIO/ =ABORTIO Examples To abort a pending I/O request for logical device 53, enter: ABORTIO 53 It is necessary to issue several ABORTIO commands to abort all pending I/O operations on a spooled device, as shown below: STOPSPOOL 5 11:20/31/SP#5/STOPPED 11:20/31/LDEV#5 NOT READY REFUSE 5 ABORTIO 5 ABORTIO 5 11:21/40/NO I/O TO ABORT FOR DEVICE 5 Related Information Commands SHOWDEV Manuals Performing System Operation Tasks 40 Chapter 2
Command Definitions A-B ABORTJOB/ =ABORTJOB ABORTJOB/ =ABORTJOB Aborts a job or session. Syntax ABORTJOB{ =ABORTJOB{ #Jnnn #Snnn [ jobname,] user.acct } #Jnnn #Snnn [ jobname,] user.acct } Parameters #Jnnn A job number. #Snnn A session number. jobname The name of the job, as identified by the SHOWJOB command. user A user name. acct An account name.
Command Definitions A-B ABORTJOB/ =ABORTJOB The standard error message that appears when a request is manually terminated by entering Y in response to =REPLY (or REPLY) is displayed on the user's terminal: SESSION ABORTED BY SYSTEM MANAGEMENT The =ABORTJOB command may be used at the physical console if ABORTJOB is ineffective. Refer to the "Use" section of this command. Use You may issue this command from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions A-B ACCEPT ACCEPT Permits a designated device to accept jobs/sessions and/or data. Syntax ACCEPT[ JOBS | DATA ] ,ldev Parameters JOBS The designated device recognizes the JOB and HELLO commands. The device must be interactive to support sessions. DATA The designated device recognizes the DATA command. Data-accepting devices are not supported. NOTE If you omit both the JOBS and the DATA parameters, then both the JOB and HELLO commands, and the DATA command are allowed.
Command Definitions A-B ACCEPT Examples To permit logical device 19 to accept jobs and data, enter: ACCEPT 19 SHOWDEV 19 LDEV AVAIL 19 AVAIL OWNERSHIP VOLID ASSOCIATION To permit logical device 19 to accept jobs and data, and to allow the device to be spooled, enter: ACCEPT 19 STARTSPOOL 19 11:12/31/SP#/SPOOLED IN 11:12/6/LDEV#19 NOT READY SHOWDEV 19 DEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION 19 SPOOLED SPOOLER OUT Related Information Commands REFUSE Manuals Introduction to MPE XL for MPE V System Ad
Command Definitions A-B ALLOCATE ALLOCATE Loads a compatibility mode program or procedure into virtual memory. Syntax ALLOCATE [ PROCEDURE, | PROGRAM, ] name Parameters PROCEDURE The procedure in SL.PUB.SYS to be allocated. The default is PROGRAM. PROGRAM The program file to be allocated. Default. name The name of the program file or procedure to be allocated.
Command Definitions A-B ALLOCATE In addition to comma (,) a semicolon (;) and equal sign (=) may be used as a delimiter. Example To allocate a procedure identified as PROC1, that resides in SL.PUB.SYS, enter: ALLOCATE PROCEDURE,PROC1 Program files residing in the nonsystem domain (a volume set) are not allocated. Attempts to do so result in a LOAD ERR 92 message.
Command Definitions A-B ALLOW ALLOW Grants a user access to a specific operator command. Syntax ALLOW FILE=formaldesignator[ ;SHOW] ALLOW[ @.@ | user.@ | @.acct | user.acct ;COMMANDS=command [ ,command,...] Parameters formal- designator An ASCII file name, which may consist of one to eight alphanumeric characters, beginning with an alphabetic character. It may be fully or partially qualified and may be back-referenced in a file equation. SHOW Lists input lines on $STDLIST. @.
Command Definitions A-B ALLOW 2 JOHN.ACCTNG;COMMANDS=ALTJOB,DELETESPOOLFILE 3 // ... /KEEP ALLOWTMP /E Once you create an indirect file, you then issue the ALLOW command, using the ;SHOW parameter to display each command line as it is executed from the file. For example: ALLOW FILE=ALLOWTMP;SHOW You may backreference the file with a file equation as follows: FILE BACKF=ALLOWTMP ALLOW FILE=*BACKF;SHOW If the file has a lockword, enter it in the command line after the filename.
Command Definitions A-B ALLOW CONSOLE DELETESPOOLFILE DISALLOW DISCRPS DOWN DOWNLOAD HEADOFF MRJECONTROL OPENQ OUTFENCE REFUSE REPLY RESUMEJOB SPOOLER VMOUNT VSCLOSE VSOPEN VSRELEASESYS VSRESERVESYS WARN WELCOME Use You may issue this command from a session, job, program, or in BREAK. Pressing Break will terminate subsystem mode and produce an error message but has no effect on commands already entered in subsystem mode.
Command Definitions A-B ALTACCT ALTACCT Changes the attributes of an existing account. Syntax ALTACCT acctname [ ;PASS=[ password] ] [ ;FILES=[ filespace]] [ ;CPU=[ cpu]] [ ;CONNECT=[ connect] ] [ ;CAP=[ capabilitylist] ] [ ;ACCESS=[ (fileaccess)]] [ ;MAXPRI=[ subqueuename] ] [ ;LOCATTR=[ localattribute] ] [ ;ONVS=volumesetname] [ ;USERPASS=[ {REQ | OPT } ] ] (1) (1) The USERPASS parameter is only available if the HP Security Monitor has been installed.
Command Definitions A-B ALTACCT If a capability is removed at the account level, users within the account are also denied that capability. No explicit change to the user's capabilities is necessary. Similarly, if a capability is returned to the account, any users with that capability regain it automatically.
Command Definitions A-B ALTACCT subqueuename CAUTION localattribute Name of the highest priority subqueue that can be requested by any process of any job/session in the account, specified as AS, BS, CS, DS, or ES. When you specify ;MAXPRI= without a value, subqueuename defaults to CS. User processes executing in the AS or BS subqueues can deadlock the system. If you assign these subqueues to nonpriority processes, other critical system processes may be prevented from executing.
Command Definitions A-B ALTACCT Table 2-2 Default Parameters for the ALTACCT Command Parameter Default Values password No password filespace Unlimited cpu Unlimited connect Unlimited capabilitylist AM, AL, GL, SF, ND, IA, BA (All accounts except SYS) SM, AM, AL, GL, DI, OP, SF, ND, PH, DS, MR, PM (SYS account only) (R,A,W,L,X:AC) (All accounts except SYS) fileaccess (R,X:ANY;A,W,L:AC) (SYS account only) subqueuename CS subqueue localattribute 0 (null) Any value changed with the ALTACCT comm
Command Definitions A-B ALTACCT To change the password and the file space of an account called MALCHIOR in the volume set TIME_LORD, you need to issue two commands: ALTACCT MALCHIOR;PASS=OMSBOROS ALTACCT MALCHIOR;ONVS=TIME_LORD;FILES=20000 You must specify the changes for the system volume set (the first command) and for the volume set itself (the second command). Specifying a volumesetname limits the user to changing only FILES in the second command.
Command Definitions A-B ALTFILE ALTFILE Changes the attributes of an existing file or directory. (Native Mode) Syntax ALTFILE[ FILE=] filename [ ] ;OWNER=ownername] ] [ [ ;GROUPID=] POSIXgroupname] Parameters filename The filename of the object to be altered, specified in either MPE or HFS syntax. The filename may name a file, hierarchical directory, root, MPE group or account. Note that MPE groups or accounts can ONLY be named via HFS (Hierarchical File System) syntax.
Command Definitions A-B ALTFILE In order to change the GID of a file, you must be one of the following: • The file owner (your logon name matches the UID of the file). In this case, POSIXgroupname must specify your logon account. • The file's account manager (your logon account matches the GID of the file and you have the MPE/iX account manager (AM) capability). In this case, POSIXgroupname must specify the account manager's logon account.
Command Definitions A-B ALTGROUP ALTGROUP Changes one or more attributes of a group. Syntax ALTGROUP groupname [ .acctname] [ ;PASS=[ password]] [ ;CAP=[ capabilitylist] ] [ ;FILES=[ filespace] ] [ ;CPU=[ cpu] ] [ ;CONNECT=[ connect] ] [ ;ACCESS=[ (fileaccess)] ] [ ;ONVS=volumesetname] [ ;HOMEVS=volumesetname] Parameters groupname The name of the group whose attributes are to be changed. acctname The name of the account in which the group is to reside.
Command Definitions A-B ALTGROUP Each capability is denoted by a two letter mnemonic, as follows: Process Handling = PH Extra Data Segments = DS Multiple RINs = MR Privileged Mode = PM Interactive Access = IA Batch Access = BA Default is IA, BA except for the PUB group of the SYS account which has no true default. It is assigned the maximum group capabilities when the system is delivered and should not normally be changed. filespace Disk storage limit, in sectors, for the permanent files of the group.
Command Definitions A-B ALTGROUP The user types are specified as follows: ANY = AC = GU = AL = GL = Any user Member of this account only Member of this group only Account librarian user only Group librarian user only To specify two or more user or access types, separate them by commas. ONVS A particular volume set for which the group attributes are to be changed. The volume set must be already defined and recognized by the system.
Command Definitions A-B ALTGROUP unchanged. When a keyword is included but the corresponding parameter is omitted (as in PASS = Return), the default value is assigned. Table 2-3 lists the default values for the ALTGROUP command. Table 2-3 shows the default values for the ALTGROUP Command. Table 2-3 Default Values for the ALTGROUP Command Parameter Default Values password Null (No password) IA, BA (except PUB.SYS) PH, DS, MR, PM, IA, BA (PUB.
Command Definitions A-B ALTGROUP However, if LEILA does contain files, you cannot change the home volume set for this group without creating a new group and transferring those files to it.
Command Definitions A-B ALTJOB ALTJOB Alters the attributes of waiting or scheduled jobs. (Native Mode) Syntax ALTJOB[ JOB=] { #Jnnn #Snnn } [ ;INPRI=inputpriority] [ ;OUTDEV={ ldev devclass } ] [.HIPRI][;JOBQ=queuename] Parameters #Jnnn A job number. #Snnn A session number. (Although syntactically correct, this parameter is rarely used: sessions do not wait.) inputpriority The new input priority (0 = lowest; 14 = highest).
Command Definitions A-B ALTJOB JOBFENCE 14 15:11/#J1/24/DEFERRED JOB INTRODUCED ON LDEV #53 15:11/#J2/25/DEFERRED JOB INTRODUCED ON LDEV #53 15:13/#J3/26/DEFERRED JOB INTRODUCED ON LDEV #53 SHOWJOB JOBNUM #S23 #J1 #J2 #J3 STATE IPRI JIN JLIST INTRODUCED JOB NAME EXEC 20 20 WAIT D 8 10S 12 WAIT D 8 10S 12 WAIT D 8 10S 12 THU 2:15P OPERATOR.SYS THU 3:11P JOB2,OP.SYS THU 3:11P JOB3,SUE.PAYROLL THU 3:13P JOB1,JIM.
Command Definitions A-B ALTLOG ALTLOG Alters the attributes of an existing user logging identifier. Syntax ALTLOG logid [ ;LOG=logfile { ,DISC ,TAPE } ] [ ;PASS=password[ { ;AUTO ;NOAUTO } ] Parameters logid The logging identifier whose attributes are to be changed. This identifier must contain from one to eight alphanumeric characters, beginning with an alphabetic character. logfile The name of the file to receive data from the logging procedure.
Command Definitions A-B ALTLOG Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. User logging (LG) capability is required to use this command. Example To change the destination log file of the logging identifier KIM to log file C and specify that C resides on disk, enter: ALTLOG KIM;LOG=C,DISC Since the keyword parameter, PASS=, was omitted, KIM retains any password previously specified.
Command Definitions A-B ALTPROC ALTPROC Changes characteristics of the specified processes. Currently, a process' priority, queue attribute, and workgroup may be changed. (Native Mode) Syntax ALTPROC[ [ PIN=] { pinspec (pinspec [ ,pinspec ] ...) } [ ;JOB=] { jobspec (jobspec [ ,jobspec ] ...) } ] [ [ ;PRI=] pri [ ;WG= ] { workgrp NATURAL_WG } ] [ { ;TREE ;NOTREE }] [{ ;USER ;ANYUSER } ] [ ;SYSTEM] Parameters pinspec The process(es) you want to alter.
Command Definitions A-B ALTPROC However, if you add anyuser to the same command as shown below, then all job processes are altered. :ALTPROC job=@j;pri=cs;anyuser TREE is the default for all jobspec target processes, and can be overridden with the NOTREE option. The SYSTEM option is ignored for all jobspec target processes. The jobspec is optional as long as a pinspec is supplied. If both are omitted, an error is reported. pri The queue or absolute priority for the process.
Command Definitions A-B ALTPROC priority specified need not fall between the base and limit priorities of the workgroup. To assign an absolute priority value, you must have SM capability. If you do not have SM capability, then your MAXPRI value represents the highest priority that you can assign a process. A warning appears when the specified priority exceeds MAXPRI. MAXPRI is ignored for System Manager (SM) capability. A workgroup value {workgrp} moves the target process(es) to the specified workgroup.
Command Definitions A-B ALTPROC Operation Notes To execute the ALTPROC command, you must have System Supervisor (OP) or System Manager (SM) capability. SM capability is necessary to alter system processes, for the WG= option, for certain specifications to the PRI option, and to increase a process' priority above MAXPRI. You may issue the ALTPROC command from a session, job, program, or while in BREAK. Pressing Break aborts the execution of this command.
Command Definitions A-B ALTSEC ALTSEC Changes the access permissions of an object by altering the access control definition (ACD). ACDs are the main method of controlling access to files, hierarchical directories, and devices. ACDs are automatically assigned to hierarchical directories and to files existing in hierarchical directories.
Command Definitions A-B ALTSEC MPE Syntax You can include MPE file name Syntax but not RFA information. If the object is an MPE Syntax file, its format is: filename[/lockword][.groupname[.acctname]] You may specify file lockwords for files protected by active lockwords unless the objects are also protected by a current ACD. In a batch job, if a lockword exists on a file, you must specify it. In a session, if a lockword exists and is omitted, MPE/iX will prompt you for it.
Command Definitions A-B ALTSEC You may specify two or more user types if you separate them by commas. The default is R,L,W,A,X:ANY. The colon (:) separating one or more modes from one or more user types is required punctuation in the specification of fileaccess. NEWACD Creates a new ACD for the specified object. NEWACD is used when an ACD does not currently exist. It must be followed by valid ACD pair(s) as described below. REPACD Indicates "replace ACD".
Command Definitions A-B ALTSEC You cannot use wildcards in any other manner within a user specification. A typical ACD consisting of three ACD pairs might look like this: (R,W:ENGR.MFG;R,W,RACD:@.MRKT;R:@.@) This ACD would allow Read and Write access to the ENGR user of the MFG account; Read and Write access to any user of the MRKT account along with the ability to read or copy the ACD; and Read access to any user in any account. ^ filereference A file containing one or more ACD pairs.
Command Definitions A-B ALTSEC Operation Notes You use the ALTSEC command to alter security provisions for files, hierarchical directories, devices, and device classes by manipulating an object's access control definition (ACD) or its access mask. All of these objects may have ACDs, but only files have access masks which can be changed using this command. An object's ACD may be altered using this command with the ACD keywords NEWACD, REPACD, COPYACD, ADDPAIR, REPPAIR, DELPAIR, DELACD, and MASK.
Command Definitions A-B ALTSEC ALTSEC FPROG;ACCESS=(X:GU;R,W:AL,GL) ACD Examples To view ACD information, use the LISTFILE,-2 command. This form of the LISTFILE command displays only ACD information. You have created a file named FDATA, and want to assign a new ACD to FDATA, granting write access to a user named FRIEND.ACCT. Enter: ALTSEC FDATA;NEWACD=(W:FRIEND.ACCT) As the creator of a file, you can access the file by default, so you don't need to grant yourself access through an ACD.
Command Definitions A-B ALTSEC Note that L and A (lock and append) need not be specified because they are implied with W (write). To add an ACD that prevents any user except OPERATOR.SYS (and any user with SM capability) from accessing LDEV 7 (a tape drive), enter: ALTSEC 7,LDEV;NEWACD=(R,W:OPERATOR.SYS) Note in the last example that X is not used because it makes no sense to execute a tape drive. It also makes no sense to lock or append a tape drive but W tacitly provides L and A anyway.
Command Definitions A-B ALTSPOOLFILE ALTSPOOLFILE Alters the characteristics of an output spoolfile. Syntax ALTSPOOLFILE{ #Onnn ldev1 } { ;PRI=outputpriority ;COPIES=numcopies ;DEV={ ldev2 devclass } ;DEFER } [ ;...] Parameters #Onnn The output device file identification of a spoolfile. ldev1 The logical device number of the device where an ACTIVE spoolfile currently resides. outputpriority The output priority of the designated device file (0 = lowest; 14 = highest).
Command Definitions A-B ALTSPOOLFILE You may alter the outputpriority or the numcopies of an ACTIVE spoolfile without interrupting the printing process. If you alter the device or defer the ACTIVE spoolfile with the DEFER parameter, the printer stops immediately. In both cases, the entire file is printed when printing resumes. Deferring a spoolfile lowers its output priority to zero, the lowest priority possible.
Command Definitions A-B ALTUSER ALTUSER Changes the attributes currently defined for a user. Syntax ALTUSER username[ .acctname] [ ;PASS=[ password] ] [ ;CAP=[ capabilitylist] ] [ ; MAXPRI=[ subsueuename] ] [ ;LOCATTR=[ localattribut] ] [ ;HOME=[ homegroupname] ] [ ;UID=[ uid] [ ;USERPASS=[ req opt ] [ Expired] ] The USERPASS parameter is only available if the HP Security Monitor has been installed. Parameters username The name assigned to the user within a logon account.
Command Definitions A-B ALTUSER Save Files = SF Access to Nonshareable I/O Devices = ND Use Volumes = UV Create Volumes = CV Use Communication Subsystem CS Programmatic Sessions = PS User Logging = LG Process Handling = PH Extra Data Segments = DS Multiple RINs = MR Privileged Mode = PM Interactive Access = IA Batch Access = BA Programmatic Sessions = PS Default is SF, ND, IA, and BA. Note that CV automatically gives the user UV capability, and removal of UV results in automatic removal of CV.
Command Definitions A-B ALTUSER Opt USERPASS=OPT specifies that users in this account may or may not have passwords. If you do not use the USERPASS parameter, the old value remains. It is available only if the HP Security Monitor has been installed. Expired The password expires immediately. The user cannot logon without selecting a new password. It is only available if the HP Security Monitor has been installed.
Command Definitions A-B ALTUSER Use This command may be issued from a session, a job, a program, or in break mode. Pressing Break has no effect on this command. Account manager (AM) capability is required to use this command. System manager (SM) capability is required to specify a user in an account other than your own. Examples Suppose an account's capabilities are AM, AL, GL, SF, ND, PH, DS, MR, IA, and BA.
Command Definitions A-B ASSOCIATE ASSOCIATE Gives a user operator control of a device class. Syntax ASSOCIATE devclass Parameters devclass The name of a logical device class configured with SYSGEN. Operation Notes This command links a device class, such as LP, to an individual user on the system. The user may then execute any valid operator command for a device in the device class and receive the status messages for the devices in that device class on $STDLIST.
Command Definitions A-B ASSOCIATE ASSOCIATE TAPE Related Information Commands DISASSOCIATE Manuals Performing System Operation Tasks 84 Chapter 2
Command Definitions A-B BASIC BASIC Interprets a compatibility mode BASIC/V program. BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BASIC[ commandfile] [ ,[ inputfile] [ ,listfile] ] Parameters commandfile Actual file designator of the source file or device from which BASIC/V commands and statements are input. This can be any ASCII input file. Formal file designator is BASCOM. Default is $STDINX.
Command Definitions A-B BASIC Examples To enter commands and data from your standard input device, with program listing and output transmitted to the standard output device, enter: BASIC You may also submit commands and data to the BASIC/V interpreter through input files that you have stored on disk. Files created using the editor must be kept with the UNN (unnumbered) option of the editor KEEP command.
Command Definitions A-B BASICGO BASICGO Compiles, prepares, and executes a compatibility mode BASIC/V program. BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BASICGO[ commandfile] [ ,listfile] Parameters commandfile Actual file designator of the input file from which the BASIC/V compiler commands are read. This can be any ASCII input file. Formal file designator is BSCTEXT. Default is $STDINX.
Command Definitions A-B BASICGO Example To compile, prepare, and execute the BASIC/V program MYPROG, enter: BASICGO $CONTROL USLINIT $COMPILE MYPROG $EXIT The above example begins execution of the BASIC/V compiler, initializes the USL, compiles the program MYPROG, and then exits from the compiler.
Command Definitions A-B BASICOMP BASICOMP Compiles a compatibility mode BASIC/V program. BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BASICOMP[ commandfile] [ ,[ uslfile] [ ,listfile] ] Parameters commandfile Actual file designator of the input file from which the BASIC/V compiler commands are read. This can be any ASCII input file. Formal file designator is BSCTEXT. Default is $STDINX.
Command Definitions A-B BASICOMP example, below. You may, however, build a USL file in the permanent file domain, then direct the BASIC/V compiler to store the object code in this file by naming the USL file in the BASICOMP command line. Refer to "Examples." Use 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.
Command Definitions A-B BASICPREP BASICPREP Compiles and prepares a compatibility mode BASIC/V program. BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BASICPREP[ commandfile] [ ,[ progfile] [ ,listfile] ] Parameters commandfile Actual file designator of the input file from which the BASIC/V compiler commands are read. This can be any ASCII file. Formal file designator is BSCTEXT. Default is $STDINX.
Command Definitions A-B BASICPREP Use 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.
Command Definitions A-B BBASIC BBASIC Starts execution of the HP Business BASIC/V interpreter in compatibility mode. HP Business BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BBASIC[ commandfile] [ ,[ inputfile] [ ,listfile] ] Parameters commandfile Actual file designator of the source file or device from which HP Business BASIC/V commands and statements are input. This can be any ASCII input file.
Command Definitions A-B BBASIC You may also submit commands and data to the HP Business BASIC/V interpreter through input files that you have stored on disk. Files created using the editor must be kept with the UNN (unnumbered) option of the editor's KEEP command. In this example, HP Business BASIC/V interpreter commands and statements are submitted from the command file MYCOMDS. The data that the program uses is stored in the input file MYDATA.
Command Definitions A-B BBASICGO BBASICGO Compiles, prepares, and executes an HP Business BASIC/V program in compatibility mode. HP Business BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BBASICGO infile [ ,listfile] Parameters infile Actual file designator of the BSAVE file containing the HP Business BASIC/V program to be compiled. Formal file designator is BBCIN.
Command Definitions A-B BBASICGO Related Information Commands BBASIC, BBASICOMP, BBASICPREP Manuals HP Business BASIC/XL Reference Manual MPE Segmenter Reference Manual 96 Chapter 2
Command Definitions A-B BBASICOMP BBASICOMP Compiles an HP Business BASIC/V program in compatibility mode. HP Business BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BBASICOMP infile [ ,[ uslfile] [ ,listfile] ] Parameters infile Actual file designator of the BSAVE file containing the HP Business BASIC/V program to be compiled. Formal file designator is BBCIN.
Command Definitions A-B BBASICOMP A BSAVE program file can be created from within the HP Business BASIC/V interpreter after it is written, by using the HP Business BASIC/V interpreter >SAVE filename command. The program may be compiled with the BBASICOMP command, then prepared with the PREP command, and executed with the RUN command . Use 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.
Command Definitions A-B BBASICPREP BBASICPREP Compiles and prepares an HP Business BASIC/V program in compatibility mode. HP Business BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax BBASICPREP infile [ ,[ progfile] [ ,listfile] ] Parameters infile Actual file designator of the BSAVE file containing the HP Business BASIC/V program to be compiled. Formal file designator is BBCIN.
Command Definitions A-B BBASICPREP Use 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.
Command Definitions A-B BBXL BBXL Initiates execution of the HP Business BASIC/XL interpreter. HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. (Native Mode) Syntax BBXL[ commandfile] [ ,[ inputfile] [ ,[ listfile] ] ] [ ;XL=xllist] 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.
Command Definitions A-B BBXL Use This command may be issued from a session, job, or program. It is not available in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.
Command Definitions A-B BBXLCOMP BBXLCOMP Compiles an HP Business BASIC/XL program. HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. (Native Mode) Syntax BBXLCOMP textfile [ ,[ objectfile] [ ,listfile] ] 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.
Command Definitions A-B BBXLCOMP NOTE The formal file designators used in this command (BBCIN, BBCOBJ, and BBCLIST) 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. Operation Notes The BBXLCOMP command compiles a source program stored in a BASIC SAVE file generated by the HP Business BASIC/XL interpreter.
Command Definitions A-B BBXLCOMP Manuals Chapter 2 HP Business BASIC/XL Migration Guide HP Business BASIC/XL Reference Manual 105
Command Definitions A-B BBXLGO BBXLGO Compiles, links, and executes an HP Business BASIC/XL program. HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. (Native Mode) Syntax BBXLGO textfile [ ,[ listfile] ] [ ;XL=xllist] 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.
Command Definitions A-B BBXLGO Use 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.
Command Definitions A-B BBXLGO Example To compile, link, and execute the HP Business BASIC/XL program MYPROG and direct the listing to the disk file LISTFL, enter: BBXLGO MYPROG,LISTFL Related Information Commands BBXL, BBXLCOMP, BBXLLK Manuals HP Business BASIC/XL Migration Guide HP Business BASIC/XL Reference Manual 108 Chapter 2
Command Definitions A-B BBXLLK BBXLLK Compiles and links an HP Business BASIC/XL program. HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. (Native Mode) Syntax BBXLLK textfile [ ,[ progfile] [ ,listfile] ] 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.
Command Definitions A-B BBXLLK Use 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.
Command Definitions A-B BREAKJOB BREAKJOB Suspends an executing job. (Native Mode) Syntax BREAKJOB #Jnnn Parameters #Jnnn A job number. Operation Notes The operator can use the BREAKJOB command to suspend any executing job, including spooled and streamed jobs. A job using a critical system resource is not suspended until it releases the resource. When you issue the BREAKJOB command for a job that controls a nonshareable device, a console message is displayed listing the device(s) that the job controls.
Command Definitions A-B BUILD BUILD Creates and immediately allocates a new empty file on disk.
Command Definitions A-B BUILD • File names can contain (but not begin with ) a dash (-). File names are of the form path/filename where the path/filename combination may have a maximum of 255 characters. recsize Record size. A positive number indicates words, while a negative number indicates bytes for new files only. For fixed length files, this is the logical record size. For undefined length files, this is the maximum record size.
Command Definitions A-B BUILD TEMP Indicates that the file is created as a temporary file and is saved in the job/session temporary file domain when closed. The default is that a permanent file is created. dsdevice The device class name or logical device number used to open a communications link to a remote computer that contains the source file. The default is the local system, or the computer on which the transfer request originates.
Command Definitions A-B BUILD RIO and NORIO specifications affect only the physical characteristics of the file. If NOBUF is specified in the FILE command, the file is not accessed in RIO mode; otherwise, RIO access is used with RIO files. Special operations on RIO files, such as replicating an RIO file, set NOBUF access. Refer to the Accessing Files Programmer's Guide for a discussion of relative I/O. STD, MSG, CIR, KSAMXL, SPOOL Defines the type of file. The default is STD (standard MPE/iX disk file).
Command Definitions A-B BUILD ;KEY= (keytype,keylocation,keysize [,DUP|RDUP]; . . keytype,keylocation,keysize [,DUP|RDUP]) One key specification (keytype, keylocation, keysize [,DUP|RDUP] must be included for each key in the KSAM file. The first occurrence of the key specification describes the primary key; each subsequent key specification describes an alternate key. There may be up to 15 alternate key specifications in addition to the primary key description.
Command Definitions A-B BUILD If the NOREUSE option is used, deleted record space is not reused. If the DUP option is specified for a key, duplicate records are placed chronologically at the tail end of the file. The default is NOREUSE. langid An integer number indicating the native language of the KSAM file to be built. The default is 0, or NATIVE-3000. The language must be currently configured on the system. See the Native Language documentation for more information.
Command Definitions A-B BUILD Examples The following example creates a permanent disk file named WORKFILE, which can reside on any disk. WORKFILE has fixed length records of 80 bytes each. The records are blocked 3 records per block (which is the blockfactor), and are written in ASCII code. The file has a maximum capacity of 2000 records divided into 10 extents with 2 extents initially allocated.
Command Definitions A-B BYE BYE Ends an interactive session. (Native Mode) Syntax BYE Parameters None. Operation Notes This command terminates a session and displays the CPU-time used (in seconds), connect-time (in minutes), and the date and time, as follows: CPU=48. CONNECT=35. FRI, MAY 4, 1987, 10:56 PM If you enter the HELLO command without logging off your current session, MPE/iX terminates your current session and immediately initiates a new one.
Command Definitions A-B BYE 120 Chapter 2
Command Definitions C-E 3 Command Definitions C-E Chapter 3 121
Command Definitions C-E CALC CALC Evaluates an expression. (Native Mode) Syntax CALC expression 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. Parameters expression The expression to be evaluated. Operation Notes The CALC command evaluates expression and displays the result to $STDLIST. Expressions can yield integer, string, or Boolean results.
Command Definitions C-E CALC Do not use the FINFO function with the CALC command for remote files. It ignores their existence and returns incorrect information. Use This command is available in a session, job, program, or in BREAK. Pressing Break terminates the INPUT( ) function.
Command Definitions C-E CCXL CCXL Compiles an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXL[ textfile] [ ,[ objectfile] [ ,[ listfile] ] ] [ ;INFO=quotedstring] 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.
Command Definitions C-E CCXL 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 from a session or the printer from a batch job. The formal file designator is CCLIST. If listfile is $NULL or a file other than $STDLIST, the compiler displays on $STDLIST those lines that contain errors.
Command Definitions C-E CCXL Examples The following example compiles an HP C/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. CCXL The next example compiles an HP C/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.
Command Definitions C-E CCXLGO CCXLGO Compiles, links, and executes an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXLGO[ textfile] [ ,[ listfile] ] [ ;INFO=quotedstring] NOTE This command follows the optional MPE/iX command line syntax.
Command Definitions C-E CCXLGO Operation Notes The CCXLGO command compiles, links, and executes an HP C/iX program. If textfile is omitted, the compiler expects input from your standard input device. If you do not specify listfile, the compiler sends the program listing to the formal file designator CCLIST (default is $STDLIST). The object file created during compilation is a system-defined temporary file, $NEWPASS, which is passed directly to the Link Editor as $OLDPASS.
Command Definitions C-E CCXLLK CCXLLK Compiles and links an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXLLK[ textfile] [ ,[ [ progfile] ] [ ,[ listfile] ] ] [ ;INFO=quotedstring] NOTE This command follows the optional MPE/iX command line syntax.
Command Definitions C-E CCXLLK Operation Notes The CCXLLK command compiles and links an HP C/iX program into a file on disk. If you do not specify textfile, the compiler expects input from the current input device. If you do not specify listfile, the compiler sends the listing output to the formal file designator CCLIST (default $STDLIST). The object file created during compilation is a system-defined temporary file, $NEWPASS, which is passed directly to the Link Editor as $OLDPASS.
Command Definitions C-E CHANGELOG CHANGELOG Changes the user logging file without stopping or interrupting the logging process. Syntax CHANGELOG logid[ ;DEV=device] Parameters logid Name of the currently active user logging process. This name may contain from one to eight alphanumeric characters, beginning with an alphabetic character. device Name of the device on which the new logging file is to be created. The device may be either DISC or TAPE. Default is DISC.
Command Definitions C-E CHANGELOG Mount new tape volume for changelog of logid AAA (ulogmsg 40). Normally when a user logging file is full, the system terminates the logging process and displays an appropriate message. However, by specifying the AUTO parameter in a GETLOG or ALTLOG command, you enable an automatic CHANGELOG, thereby eliminating the need to issue the CHANGELOG command manually. Refer to the ALTLOG and GETLOG commands in this chapter.
Command Definitions C-E CHANGELOG Related Information Commands ALTLOG, GETLOG, LISTLOG, LOG, OPENLOG, RELLOG, SHOWLOG, SHOWLOGSTATUS Manuals User Logging Programmer's Guide Chapter 3 133
Command Definitions C-E CHDIR CHDIR Changes the process' current working directory (CWD). (Native Mode) Syntax CHDIR[ [ DIR=] dir_name] [ ;SHOW | NOSHOW] Parameters dir_name The name of the directory you want to change to, which is assumed to be an MPE name unless you specify otherwise. To change to an HFS-named directory, begin dir_name with a dot (.) or a slash (/). The dir_name may not end in a slash, and using wildcards is not allowed. This parameter is optional.
Command Definitions C-E CHDIR Affects CHGROUP CHDIR Accumulation of CPU and Connect times yes no Set of accessible files yes no CWD of process yes yes HPCWD variable yes yes Disk space accumulation yes no Use The CHDIR command may be invoked from a job, a session, a program, or in Break. Pressing Break has no effect on this command.
Command Definitions C-E CHDIR Related Information Commands CHGROUP, FINDDIR (UDC), LISTFILE, LISTDIR (UDC), NEWDIR, PURGEDIR Manuals Performing System Management Tasks 136 Chapter 3
Command Definitions C-E CHGROUP CHGROUP Switches you from the current group to another group within the logon account to which you are allowed access. (Native Mode) Syntax CHGROUP[ [ groupname] [ /grouppass] ] 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. Parameters groupname The name of the group to which the user is switched. If the parameter is omitted, the user is switched to the home group.
Command Definitions C-E CHGROUP Examples To switch the user from the current group to the group called GORODA, enter: CHGROUP GORODA To switch the user from the current group to the group called GORODA, with the assigned password MUSASHI, enter: CHGROUP GORODA/MUSASHI To switch the user from the current group to the user's home group, enter: CHGROUP Related Information Commands CHDIR, HELLO Manuals None 138 Chapter 3
Command Definitions C-E COB74XL COB74XL Compiles an HP COBOL II/iX program using the 1974 ANSI standard entry point and creates an object file. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system.
Command Definitions C-E COB74XL The functionality of NMRLS closely maps to the MPE/V USLS. Refer to the HP COBOL/XL Programmer's Guide (31500-90002) for information on the RLINIT and RLFILE commands that cause creation of an NMRL by default or initialization. The compiler may issue an error message telling you that a new or existing object file is too small to contain the compiler's output or number of modules. In that case you must build a larger file or use the Link Editor to clean the NMRL.
Command Definitions C-E COB74XL Once the file is created, XDB expects the fully qualified name of the file to be unchanged. A FILE equation could be used if the file is renamed. Operation Notes The COB74XL command compiles an HP COBOL II/iX program into an object file on disk. If you do not specify textfile, HP COBOL II/iX expects your input from your standard input device. If you do not specify listfile, HP COBOL II/iX sends the program listing to the current list device.
Command Definitions C-E COB74XL 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 compiling code.
Command Definitions C-E COB74XLG COB74XLG Compiles, links, and executes an HP COBOL II/iX program using the ANSI 1974 standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system.
Command Definitions C-E COB74XLG line make an ampersand (&) the last character of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file: COB74XLG SALARIES;INFO="$CONTROL & BOUNDS,MAP,VERBS$SET&$X9=ON" & COB74XLG ACCOUNTS;INFO="$DEFINE %A=5#" workspacename This parameter is the actual file designator of an HPToolset workspace. The formal file designator created by the compiler is COBWKSP.
Command Definitions C-E COB74XLG Examples To compile, link, and execute an HP COBOL II/iX program entered from your standard input device and send the program listing to your standard list device, enter: COB74XLG To compile, link, and execute an HP COBOL II/iX program from the disk file TEXTFL and send the program listing to the disk file LISTFL, enter: COB74XLG TEXTFL,LISTFL Related Information Commands COB74XL, COB74XLK, LINK, RUN, XEQ, LINKEDIT Utility Manuals HP COBOL II/XL Reference Manual HP COB
Command Definitions C-E COB74XLK COB74XLK Compiles and links an HP COBOL II/iX program using the 1974 ANSI standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system.
Command Definitions C-E COB74XLK commands. To extend the quotedstring string over more than one physical line, make an ampersand (&) the last character of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file: COB74XLK SALARIES,SALPRG;INFO="$CONTROL & BOUNDS,MAP,VERBS$SET&$X9=ON" & COB74XLK ACCOUNTS;INFO="$DEFINE %A=5#" workspacename This parameter is the actual file designator of an HPToolset workspace.
Command Definitions C-E COB74XLK Examples To compile and link an HP COBOL II/iX program entered from your standard input device with the listing printed on the standard list device, enter: COB74XLK To compile and link an HP COBOL II/iX source program input from the text file SFILE into a program file named MYPROG, with the resulting listing sent to the current list device, enter: COB74XLK SFILE,MYPROG Related Information Commands COB74XL, COB74XLG, LINK, RUN, XEQ, LINKEDIT Utility Manuals HP COBOL II/
Command Definitions C-E COB85XL COB85XL Compiles an HP COBOL II/iX program using the 1985 ANSI standard entry point and creates an object file. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system.
Command Definitions C-E COB85XL Refer to the HP COBOL/XL Programmer's Guide (31500-90002) for information on the RLINIT and RLFILE commands that cause creation of an NMRL by default or initialization. The compiler may issue an error message telling you that a new or existing object file is too small to contain the compiler's output or number of modules. In that case you must build a larger file or use the Link Editor to clean the NMRL. You may then recompile to the new file.
Command Definitions C-E COB85XL Operation Notes The COB85XL command compiles an HP COBOL II/iX program into an object file on disk. If you do not specify textfile, HP COBOL II/iX expects the source text to be entered from your standard input device. If you do not specify listfile, HP COBOL II/iX sends the program listing to the current list device.
Command Definitions C-E COB85XL BUILD RLFILE;DISC=10000;CODE=NMRL COB85XL MAIN, RLFILE COB85XL SUB, RLFILE LINK RLFILE, SOMEPROG RUN SOMEPROG Related Information Commands COB85XLG, COB85XLK, LINK, RUN, XEQ, LINKEDIT Utility Manuals HP COBOL II/XL Reference Manual HP COBOL II/XL Programmer's Guide HP Link Editor/iX Reference Manual 152 Chapter 3
Command Definitions C-E COB85XLG COB85XLG Compiles, links, and executes an HP COBOL II/iX program using the ANSI 1985 standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system.
Command Definitions C-E COB85XLG line, make an ampersand (&) the last character of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file: COB85XLG SALARIES;INFO="$CONTROL & BOUNDS,MAP,VERBS$SET&$X9=ON" COB85XLG ACCOUNTS;INFO="$DEFINE %A=5#" workspacename This parameter is the actual file designator of an HPToolset workspace. The formal file designator created by the compiler is COBWKSP.
Command Definitions C-E COB85XLG Examples To compile, link, and execute an HP COBOL II/iX program entered from your standard input device and send the program listing to your standard list device, enter: COB85XLG To compile, link, and execute an HP COBOL II/iX program from the disk file TEXTFL and send the program listing to the disk file LISTFL, enter: COB85XLG TEXTFL,LISTFL Related Information Commands COB85XL, COB85XLK, LINK, RUN, XEQ, LINKEDIT Utility Manuals HP COBOL II/XL Reference Manual HP COB
Command Definitions C-E COB85XLK COB85XLK Compiles and links an HP COBOL II/iX program using the 1985 ANSI standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system.
Command Definitions C-E COB85XLK commands. To extend the quotedstring string over more than one physical line, make an ampersand (&) the last character of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file: COB85XLK SALARIES,SALPRG;INFO="$CONTROL & BOUNDS,MAP,VERBS$SET&$X9=ON" COB85XLK ACCOUNTS;INFO="$DEFINE %A=5#" workspacename This parameter is the actual file designator of an HPToolset workspace.
Command Definitions C-E COB85XLK Examples To compile and link an HP COBOL II/iX program entered from your standard input device, with the listing printed on the standard list device, enter: COB85XLK To compile and link an HP COBOL II/iX source program input from the text file SFILE into a program file named MYPROG, with the listing sent to the current list device, enter: COB85XLK SFILE,MYPROG Related Information Commands COB85XL, COB85XLG, LINK, RUN, XEQ, LINKEDIT Utility Manuals HP COBOL II/XL Refere
Command Definitions C-E COBOLII COBOLII Compiles a compatibility mode COBOLII program on the COBOL 74 compiler. COBOLII 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 COB74XL.
Command Definitions C-E COBOLII 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 COBLIST. Default is $STDLIST. masterfile Actual file designator of the master file with which textfile is merged to produce a composite source. This can be any ASCII input file. The formal designator is COBMAST. Default is that the master file is not read; input is read from textfile, or from $STDIN if textfile is not specified.
Command Definitions C-E COBOLII Related Information Commands COBOLIIGO, COBOLIIPREP, LINK, RUN, XEQ, LINKEDIT Utility Manuals HP COBOL II/XL Reference Manual Chapter 3 161
Command Definitions C-E COBOLIIGO COBOLIIGO Compiles, prepares, and executes a compatibility mode COBOLII program on the COBOL 74 compiler. COBOLII 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 COB74XLG.
Command Definitions C-E COBOLIIGO Operation Notes The COBOLIIGO command compiles, prepares, and executes a compatibility mode program using the COBOL 74 compiler. If you do not specify textfile, COBOLII expects the source program to be entered from your standard input device. If you do not specify listfile, COBOLII sends the output to your standard list device. The USL file created during compilation is a system-defined temporary file, $OLDPASS, which is passed directly to the MPE segmenter.
Command Definitions C-E COBOLIIPREP COBOLIIPREP Compiles and prepares a compatibility mode COBOLII program on the COBOL 74 compiler. COBOLII 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 COB74XLK.
Command Definitions C-E COBOLIIPREP INFO=quotedstring is used in the COBOLII programming language to pass compiler options to a program. These options appear before the first line of source code in the text file. workspacename This parameter is the actual file designator of an HPToolset workspace used with HPToolset. The formal file designator created by the compiler is COBWKSP. Operation Notes The COBOLIIPREP command compiles and prepares a compatibility mode COBOLII program into a program file on disk.
Command Definitions C-E COMMENT COMMENT Inserts a comment into a command stream or user command. (Native Mode) Syntax COMMENT [text] or # [text] Parameters text Information composed of the comment text. If the last nonblank character is an ampersand (&), comment text is continued onto the next line. Default is that a record containing only the string "COMMENT" is inserted in the command stream.
Command Definitions C-E CONSOLE CONSOLE Changes the system console from its current device to another job-accepting terminal. Syntax CONSOLE[ ldev] Parameters ldev The logical device number of the new console terminal. If omitted, the CONSOLE command displays the current logical device number of the console. Operation Notes The CONSOLE command is used to display the logical device number of the terminal currently being used as the system console, or to move the console to another logical device.
Command Definitions C-E CONSOLE Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. It may be used by any user to determine the location of the console. To change the location of the console, this command must be issued from the console itself, unless distributed to users with the ALLOW command, or the user must have system manager (SM) capability.
Command Definitions C-E CONTINUE CONTINUE Overrides a job error so that the job or user command (command file or UDC) continues executing. (Native Mode) Syntax CONTINUE Parameters None. Operation Notes The CONTINUE command permits a job or session to continue even though the command immediately following the CONTINUE command results in an error (with an accompanying error message). It is not needed in a session, because sessions do not terminate when a command error occurs.
Command Definitions C-E CONTINUE Related Information Commands JOB Manuals Appendix A, "Predefined Variables in MPE/iX" 170 Chapter 3
Command Definitions C-E COPY COPY Copies one file to another by creating a new file or by overwriting an existing file. The COPY command can be used to copy files to and from HFS directories. You cannot use COPY to copy directories to or from other directories. Users with SM capabilities are able to copy files to MPE accounts outside of their current logon account.
Command Definitions C-E COPY N or NO Instructs COPY to terminate. ASK is the default, except in a job or in other cases when the user is not using interactive mode. In such cases, ASK has no meaning, and YES becomes the default. YES Instructs COPY to purge targetfile if it already exists. No message is displayed for the user, as would be the case with ASK. YES is the default in jobs, or at other times when the user is not using an interactive mode.
Command Definitions C-E COPY In the next example the file MYFILE.PUB.SYS is copied to MyFile under the current working directory (CWD). Note that the target file name has to have the dot and slash (./) prefix. COPY myfile.pub.sys, ./MyFile In the next example, the file File1 under the CWD is copied to MYFILE.PUB in the current account. COPY ./File1, myfile.pub In this next example, file1 in directory dir0 is copied to file2 in directory dir1. COPY ./dir0/file1, .
Command Definitions C-E DATA DATA Enters data into the system from a device file. (Cannot be used to enter data from $STDIN.) (Native Mode) Syntax DATA[ jsname,] username [ /userpass] .acctname [ /acctpass] [ ;filename] Parameters jsname Name of job or session that is to read data. Default is no job/session name. It may contain up to eight alphanumeric characters, beginning with a letter. username User name that allows you to access MPE/iX in this account, as established by the account manager.
Command Definitions C-E DATA Operation Notes This command identifies data to be read from a device file other than your standard job/session input device. It can be used, for example, to input a data file from a spooled input device for later use by an interactive session or a batch job. The DATA command is the only command that can be entered before a job or session is initiated. Files identified by DATA may be input only from magnetic tape on spooled tape drives or with the STREAM command.
Command Definitions C-E DATA Examples A data file is created on disk, and the STREAM command is used to make the file available to your program. To create the file DATAFL on disk, invoke a text editor (like EDITOR) and enter the data beginning with the DATA command and ending with the EOD command. For example: EDITOR /ADD DATA SESSB,BROWN.ACCT1 . . .
Command Definitions C-E DEALLOCATE DEALLOCATE Deallocates a program or procedure previously loaded into memory with the ALLOCATE command. Syntax DEALLOCATE[ PROGRAM | PROCEDURE ] ,name Parameters PROGRAM The program file indicated by name is deallocated. Default. PROCEDURE The code segment containing the procedure specified by name in SL.PUB.SYS is deallocated. name The name of the program file or procedure to be deallocated.
Command Definitions C-E DEALLOCATE Manuals 178 Introduction to MPE XL for MPE V Programmers Chapter 3
Command Definitions C-E DEBUG DEBUG Instructs MPE/iX to enter the system debugger. (Native Mode) Syntax DEBUG[ commands] Parameters commands A series of system debugger commands to be executed before the debugger prompt is displayed. The string may be as many as 255 characters long. There are no delimiters or keywords needed to pass these commands to the debugger. If the CONTINUE command is not part of the commands string, you are left in debug after the execution of those commands.
Command Definitions C-E DEBUG 6) SP=40221130 RP=7d.
Command Definitions C-E DELETESPOOLFILE DELETESPOOLFILE Deletes a spoolfile from disk. Syntax DELETESPOOLFILE{ #Onnn #Innn ldev } Parameters #Onnn The identification of a READY or ACTIVE output spoolfile. #Innn The identification of a READY, input spooled data file. ldev The logical device number on which the spoolfile is ACTIVE. Operation Notes Before deleting an ACTIVE spoolfile, first take the output device offline.
Command Definitions C-E DELETESPOOLFILE When you put the device back online, the trailer page is printed, and the file deleted. If you have suppressed header/trailer output with the HEADOFF command, no trailer is printed before the spoolfile is deleted. However, the printer skips to the top of the next physical page. If the device is a page printer, the default environment is reloaded.
Command Definitions C-E DELETEVAR DELETEVAR Deletes one or more MPE/iX variables. (Native Mode) Syntax DELETEVAR varname [ ,varname] NOTE ... [ ,varname] This command follows the optional MPE/iX command line syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning of this chapter. Parameters varname The name of the variable to be deleted. Operation Notes Deletes a specific MPE/iX variable, or all variables specified by a pattern.
Command Definitions C-E DELETEVAR Use This command is available in a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions C-E DISALLOW DISALLOW Prohibits access to a specific operator command. Syntax DISALLOW FILE=formaldesignator[ ;SHOW] DISALLOW] [ @.@ user.@ @.user user.acct ] ;COMMANDS=command [ ,command,...] Parameters formal- designator An ASCII file name, which may consist of one to eight alphanumeric characters, beginning with an alphabetic character. It may be fully or partially qualified and may be back-referenced in a file equation. SHOW Lists input lines on $STDLIST. @.
Command Definitions C-E DISALLOW NOTE Do NOT confuse operator commands with console commands. For a description of the difference between console and operator commands refer to the ALLOW command. The commands which may be disallowed are the same as the commands which may be allowed. Refer to the ALLOW command for a list of commands which may be allowed. Use This command may be issued from a session, job, program, or in BREAK.
Command Definitions C-E DISALLOW Related Information Commands ALLOW, SHOWALLOW Manuals Performing System Operation Tasks Chapter 3 187
Command Definitions C-E DISASSOCIATE DISASSOCIATE Removes control of a device class from the user. Syntax DISASSOCIATE devclass Parameters devclass The name of a device class configured during SYSGEN. Operation Notes This command negates a previously issued ASSOCIATE command by removing control of a device class from a user. The command may be issued by the system operator or by the user. The user implicitly disassociates a device when logging off.
Command Definitions C-E DISCRPS DISCRPS Enables or disables the rotational position sensing (RPS) feature on a specified logical device. It requires a special firmware upgrade CS-80 disk drives. Syntax DISCRPS ldev { ,ENABLE [ { ,value,value} ] ,DISABLE } Parameters ldev The logical device number of the specified CS-80 disk drive. ENABLE Enables rotational position sensing on the device. DISABLE Disables rotational position sensing on the device.
Command Definitions C-E DISCRPS Example To enable the RPS feature on logical device 1 and display the status of the disk drive, enter: DISCRPS 1,ENABLE SHOWDEV 1 LDEV AVAIL OWNERSHIP 1 DISC (RPS) 50 FILES VOID DEN ASSOCIATION To use the value parameter with ENABLE to set time-to-target and window size to the default values, enter: DISCRPS ldev,ENABLE,90,30 Related Information Commands SHOWDEV Manuals CS/80 Instruction Set Programmers Manual 190 Chapter 3
Command Definitions C-E DISCUSE (UDC) DISCUSE (UDC) The DISCUSE UDC executes the DISKUSE command to display disk space usage, in sectors, for one or more directories or a directory tree. This UDC is provided for those who are used to spelling disk with a "c". 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.
Command Definitions C-E DISCUSE (UDC) Refer to the DISKUSE command later in this chapter for additional examples.
Command Definitions C-E DISKUSE DISKUSE Displays disk space usage, in sectors, for one or more directories or a directory tree. Syntax DISKUSE[ [ DIR=] dir_name] [ ; TREE | NOTREE | USENAME ] Parameters dir_name Directory name for which information is being listed (optional). The dir_name is assumed to be an MPE syntax name. HFS-named directories may be shown if dir_name starts with a dot (.) or a slash (/).
Command Definitions C-E DISKUSE Use You must have traverse directory entries (TD) and read directory entries (RD) permissions to each directory contributing to the reported totals. TD access is needed to each directory component named in dir_name. (Refer to the ALTSEC command in this chapter for additional information on directory permissions.) Note that the MPE syntax cannot specify a group.account. MPE syntax only permits dir.group.acct if dir is a valid MPE name; that is, all uppercase alphanumeric.
Command Definitions C-E DISKUSE Examples The illustration below shows a hierarchical directory structure, upon which all of the succeeding examples are based. Directory names are shown as the character d plus a number (for example, d0), and file names are shown as the character f plus a number (for example f1). For illustrative purposes, the HPPROMPT variable has been set to show the current working directory (HPCWD).
Command Definitions C-E DISKUSE directory. The sum of the number of sectors reported by the following command equals the number shown under the LEVEL BELOW column. The number in the LEVEL BELOW column is zero if the reported directory is empty. LISTFILE dir_name/@,2;NOTREE (right-justified) Displays the total number of sectors used by the directory listed. This includes space used by the directory itself, all files immediately under the directory, and space used by all subdirectory entries.
Command Definitions C-E DISKUSE NOTE The output is presented in HFS syntax, even if the directory name is supplied in MPE syntax. If wildcards were used to specify the directory name in MPE syntax, then the final line of output is the user-supplied directory name (upshifted) in MPE format. Wildcards can be used to see a "horizontal cut" of disk s pace usage at an arbitrary directory depth. Wildcarding can be used in TREE and NOTREE output, as shown in the following examples. /ACCT/GROUP/d0:diskuse .
Command Definitions C-E DISMOUNT DISMOUNT Releases a volume set that was explicitly reserved by the user with a MOUNT or VSRESERVE command. The equivalent native mode command is VSRELEASE. (Native Mode) Syntax DISMOUNT[ { * volumesetname } ] [ .groupname[ .acctname] ] Parameters * or Specifies the home volume set for the group and account specified, or for the logon group and account if groupname or groupname.acctname is not specified.
Command Definitions C-E DISMOUNT Table 3-3 Command Acceptance of Naming Conventions - DISMOUNT Command Specify MPE V/E xxxMOUNT Command Accesses MPE/iX VSxxxxxx Command Accesses myset.grp. acct The volume set named myset.grp.acct. The volume set named myset.grp.acct. myset The volume set named myset.logongrp.logon acct. The volume set myset. *.grp.acct The home volume set of the group grp in account acct. Causes an error. myset_grp_ acct Error (name component longer than eight characters).
Command Definitions C-E DISMOUNT Examples To release the volume set MYSET.B.C, that was previously reserved with a MOUNT or VSRESERVE command, enter: DISMOUNT MYSET.B.C You may also use the VSRELEASE command: VSRELEASE MYSET.B.
Command Definitions C-E DO DO Allows the user to reexecute any command still retained in the command line history stack. It also permits the user to edit the command before reexecuting it, but without having to use the interactive mode of the REDO command. (Native Mode) Syntax DO[ CMD=cmdid] [ ;EDIT=editstring] This command follows the optional MPE/iX command line syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning of this chapter. NOTE Parameters cmdid The command to reexecute.
Command Definitions C-E DO Table 3-5 Editing Directives for the DO Command Directive Effect i INSERT. If text follows the i, the text following i is inserted in the current line at the position after the i. r REPLACE. If text follows the r, the text following r replaces the same number of characters in the current line, beginning at the position of r. d DELETE. Deletes a character from the current line for each specified in the edit line.
Command Definitions C-E DO Directive Effect vdelim DOWNSHIFT TO DELIMITER. Downshifts all characters starting at the position of the v and ending at, but not including, the specified delimiter. If delim is not found, no downshift occurs. You may follow this directive with other edits. v> DOWNSHIFT TO EOL. Downshifts all characters starting from the position specified by the v to the end of the current line. You may follow this directive with other edits. >text APPEND.
Command Definitions C-E DO Directive Effect c CHANGE. Changes all occurrences of one string to another in the current line when the search string and replace string are properly delimited. A proper delimiter is a nonalphabetic character (such as ', ", / or ,). The substitution is specified as: c search-string [replace-string []]. Omitting the replace-string causes occurrences of search-string to be deleted, with no substitution. u UNDO.
Command Definitions C-E DO Table 3-6 Editing Samples for the DO Command Edit Action u First occurrence undoes the previous edits. The u must be in column one. u Second occurrence undoes all edits on the current line. The u must be in column one. rxyz Replaces the current text with xyz starting at the position of r. xyz Replaces the current text with xyz starting at the position of x. ixyz Inserts xyz into the current line, starting at the position immediately before the i.
Command Definitions C-E DO Examples DO PAS Reexecutes the most recent command beginning with the string PAS. DO 10 Reexecutes command number 10 (absolute) on the command history stack. DO -2 Reexecutes the second-to-last command on the stack (one command before the most recent). DO -2, c/5A/5B Change all occurrences of 5A to 5B in the command preceding the most recent one before reexecuting it. The default is -1.
Command Definitions C-E DOIONOW DOIONOW Executes the changes to the I/O configuration made with the SYSGEN utility, while the system remains online. Syntax DOIONOW Parameters None. Operation Notes Use the DOIONOW command to start the online reconfiguration of your I/O devices. Use This command is available from a job, session, a program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions C-E DOWN DOWN Removes a device from normal system use. This command does not apply to the system console or to disk drives. Syntax DOWN ldev Parameters ldev The logical device number of the device being taken offline. Operation Notes When the DOWN command is issued for a device that is in use, the request is responded to when the process currently accessing it releases the device. The system console cannot be taken down.
Command Definitions C-E DOWN Related Information Commands SHOWDEV, UP, ABORTIO Manuals Performing System Operation Tasks Chapter 3 209
Command Definitions C-E DOWNLOAD DOWNLOAD Downloads format information to a line printer. Syntax DOWNLOAD ldev[ ,filename ,MARGIN=nn ] [ ,...] Parameters ldev The logical device number of the output device. This device must be an HP 2608 or HP 2563 Line Printer. filename The fully qualified name of a file containing the download control information. nn The print position that the first byte of data assumes. This number can be between 1 and 16, inclusive.
Command Definitions C-E DOWNLOAD Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. It may be issued only from the console unless distributed to users with the ALLOW or ASSOCIATE command. Examples To respond to a forms message such as the following: IO/15:46/22/FORMS: PLEASE MOUNT PAYCHECK FORMS.
Command Definitions C-E DSTAT DSTAT Displays the current status of the disk drives on the system. (Native Mode). Syntax DSTAT[ ldev ALL ] Parameters ldev An integer specifying the logical device number of the disk drive whose status is requested. ALL Displays the status of all disk drives, both system and nonsystem. The default is that if no parameter is included, only the status of nonsystem disks is displayed.
Command Definitions C-E DSTAT Status Meaning LONER The volume is in the LONER state when its master is not mounted or when the volume set is closed by the VSCLOSE command. MASTER A volume in this state is the master volume of a volume set. In order for the system to recognize the volume set, the master volume must be mounted. MEMBER A volume in this state belongs to a volume set whose master is mounted. If the master is not mounted, the volume is in the LONER state.
Command Definitions C-E ECHO ECHO Displays a message on the standard list device. (Native Mode) Syntax ECHO[ message] Parameters message The message to be displayed to the $STDLIST. Operation Notes Displays its argument, message, on the standard list device ($STDLIST). The command ignores delimiters. Quotation marks are not required around message. The ECHO command does not perform dereferencing of any kind. If you want variable dereferencing you must use explicit dereferencing (!) in the argument.
Command Definitions C-E ECHO ECHO !a !hi there If you entered the following command line in a user command, you would see a message when an error occurred: IF CIERROR <> 0 THEN ECHO ** A CIERROR OCCURRED!: (CIERR !CIERROR) ** The first instance of CIERROR has no dereferencing, and so ECHO treats it literally. The second instance, !CIERROR, contains explicit dereferencing, and so MPE/iX substitutes a value for the system variable CIERROR before the message is displayed to $STDLIST.
Command Definitions C-E EDITOR EDITOR Starts the EDIT/3000 subsystem, which is used to create and manipulate ASCII text or program files. Syntax EDITOR[ listfile] Parameters listfile Actual file designator of file to receive any output resulting from EDIT/3000 LIST and XPLAIN commands when the OFFLINE option is specified. It can be any ASCII output file. The formal file designator and default is EDTLIST. If specified with no device parameter, default device is LP.
Command Definitions C-E ELSE ELSE Provides an alternate execution sequence within an IF statement. (Native Mode) Syntax ELSE Parameters None. Operation Notes The ELSE command is used only in conjunction with the IF and ELSEIF commands. The IF command is used with the ENDIF command, and optionally with the ELSE command, to control the execution of a job. The IF, ENDIF, and optional ELSE commands constitute an IF block.
Command Definitions C-E ELSEIF ELSEIF Provides an alternate execution sequence within an IF statement. Native Mode Syntax ELSEIF expression [ THEN] Parameters expression Logical expression, consisting of operands and relational operators. The THEN keyword is optional. It may be used or omitted and has no effect on the results. The operators listed in Table 3-8 may be incorporated in expression.
Command Definitions C-E ELSEIF Example The following example illustrates using the ELSE command with the IF command: IF EXPN1 THEN ... ELSE IF EXPN2 THEN ... ELSE IF EXPN3 THEN ... ELSE ... ENDIF ENDIF ENDIF The same result can be accomplished more efficiently by using the ELSEIF command: IF EXPN1 THEN ... ELSEIF EXPN2 THEN ... ELSEIF EXPN3 THEN ... ELSE ... ENDIF Notice that only one ELSE may follow an ELSEIF, while any number of ELSEIF commands may follow an IF.
Command Definitions C-E ENDIF ENDIF Terminates an IF block. (Native Mode) Syntax ENDIF Parameters None. Operation Notes The ENDIF command is used to terminate an IF block. The IF command, the optional ELSE and ELSEIF commands, and the ENDIF command constitute an IF block. A logical expression is evaluated, and if true, the IF block is executed; if false, the ELSE block (if one exists) is executed. If false and no ELSE exists, then execution continues following the ENDIF.
Command Definitions C-E ENDWHILE ENDWHILE Terminates a WHILE block. (Native Mode) Syntax ENDWHILE Parameters None Operation Notes This command terminates a conditional block that begins with a WHILE command. The WHILE and ENDWHILE commands constitute a WHILE block. The WHILE command evaluates an expression, and so long as that expression evaluates as true, the command(s) between WHILE and ENDWHILE are executed.
Command Definitions C-E EOD EOD Denotes end-of-data on input stream from a job file (from an input other than $STDIN). It also terminates data initialized by the DATA command. The colon (:) is a required part of this command. (Native Mode) Syntax EOD The "&" symbol has no meaning to the input spooler when it reads records because the CI is not involved at that point. NOTE Parameters None. Operation Notes The EOD command is used to signify the end of data whose beginning was signified by a DATA command.
Command Definitions C-E EOD Use EOD is available only in a job or a session that is submitted with the STREAM command. It cannot be used directly from $STDIN or from a program. Examples To terminate a data file entered by using the STREAM command for a session identified as SESS1,BLACK.ACCTSP, your data file would contain EOD as its last record, as follows: DATA SESS1,BLACK.ACCTSP . data .
Command Definitions C-E EOJ EOJ Ends a batch job. (Native Mode) Syntax EOJ NOTE The "&" symbol has no meaning to the input spooler when it reads records because the CI is not involved at that point. Parameters None. Operation Notes The EOJ command terminates a batch job and displays the CPU-time (in seconds) and the elapsed time since the beginning of the job (rounded to the nearest minute).
Command Definitions C-E ERRCLEAR ERRCLEAR Zeros out all HP predefined error-related variables. (Native Mode) Syntax ERRCLEAR 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. Parameters None Operation Notes This command is equivalent to the following: • SETVAR CIERROR 0 • SETVAR HPCIERR 0 • SETVAR HPCIERRCOL 0 • SETVAR HPFSERR 0 Use This command is available from a job or session.
Command Definitions C-E ERRDUMP ERRDUMP Allows a user to dump either the process or system error stack to a specified depth. (Native Mode) Syntax ERRDUMP[ errorstackdepth] [ ;SYS] 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. Parameters errorstackdepth The number of error stack messages to be printed.
Command Definitions C-E ERRDUMP Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. Examples To obtain an error stack dump, enter: ERRDUMP A sample system response is: TYPE MANAGER; THE END-OF-FILE HAS BEEN DETECTED. FILE SYSTEM MESSAGE 1023. Another example specifies that the system error stack be dumped: ERRDUMP 1;SYS A sample system response is: THE STATUS OF THE TIME ENTRY IS NON-ACTIVE.
Command Definitions C-E ESCAPE ESCAPE Allows the CI programmer to simulate all aspects of CI error handling. (Native Mode) Syntax ESCAPE[ [ CIERR=] errnum] Parameters ERRNUM Sets the CIERROR variable to the absolute value of errnum and the HPCIERR variable is set to errnum. Operation Notes The ESCAPE command causes control to leave all user commands (regardless of nesting levels) and return to the CI. Batch jobs terminate (unless a CONTINUE is in effect) and sessions issue the prompt.
Command Definitions C-E ESCAPE Related Information Commands ERRCLEAR, RETURN Manuals MPE/iX Commands Reference Manual Volumes I and II Command Interpreter Access and Variables Programmer's Guide Chapter 3 229
Command Definitions C-E EXIT EXIT Terminates the command interpreter. (Native Mode) Syntax EXIT Parameters None Operation Notes When you are using MPE/iX you can start another Command Interpreter by running it as a program. To do so, you enter CI.PUB.SYS, or simply CI. If you enter this command more than once, you will create levels of the CI program. To determine what level of the command interpreter you are in, use the SHOWVAR HPCIDEPTH command. Then, to back out from the CI, enter the EXIT command.
Command Definition F-K 4 Command Definition F-K Chapter 4 231
Command Definition F-K FCOPY FCOPY Invokes the FCOPY subsystem. Syntax FCOPY[ fcopycommand] Parameters fcopycommand An FCOPY subsystem command. The FCOPY subsystem enables you to copy files or selected portions of files from any supported input device to any supported output device. There are many commands; only the most common examples are found in the "Examples" section of this command. Refer to the FCOPY Reference Manual (32212-90003) for more information.
Command Definition F-K FCOPY Related Information Commands COPY Manuals FCOPY Reference Manual Chapter 4 233
Command Definition F-K FILE FILE Declares the file attributes to be used when a file is opened. This declaration, informally known as a file equation, may be used to override programmatic or system default file specifications. With the addition of shared parameters from the NS3000/XL AdvanceNet subsystem, the declaration may specify a formal file designator that may be used to access a remote file or device in a subsequent command or intrinsic.
Command Definition F-K FILE $NULL Actual file designator of a system-wide file that is always treated as an empty file. When $NULL is accessed by a program for input, that program receives only an end-of-file indication. When it is accessed by a program for output, the associated write request is accepted by MPE/iX, but no physical output is actually performed. Do not specify parameters or options for $NULL files; if you do, you will receive an error.
Command Definition F-K FILE If the name begins with a dot (.) or a slash (/), the name is considered to follow the HFS file naming syntax rules: • File names are not upshifted. • File names can be up to 255 characters in length for absolute pathnames and 253 characters for relative pathnames. • File names can begin with, and contain, any of the following characters: a-z, A-Z, 0-9, _, -, . File names are of the form path/filename where the path/filename combination may have a maximum of 255 characters.
Command Definition F-K FILE nodespec parameter is optional; if you do not have NS3000/XL AdvanceNet, omitting the nodespec parameter makes no difference in the performance of the FILE command. However, specifying nodespec on a system that does not have NS3000/XL produces an error. The nodespec parameter is controlled by the NS3000/XL subsystem. Refer to the NS3000/XL User/Programmer Reference Manual (36920-90001).
Command Definition F-K FILE If you are opening a file that is to reside on a movable volume set, you must specify a device class that includes the drives upon which the home volume set is mounted. The file is then allocated to any of the volume set's volumes that fall within that device class. outpri The output priority requested for an output spool file. This may have a value of 1 (the lowest priority) to 13 (the highest). numcopies The number of copies requested for an output spool file.
Command Definition F-K FILE Parameters for Option recsize Record size. A positive number indicates words; a negative number indicates bytes for new files only. For fixed-length files, this is the logical record size. For undefined length files, this is the maximum record size. For variable-length files, this is the maximum logical record size if blockfactor is 1. If not, this is used to calculate the maximum logical record size and physical record size.
Command Definition F-K FILE The density value from a file equation takes precedence over the density specified in FOPEN or HPFOPEN. The supported densities are 800, 1600, and 6250. For details on the operation of density selection, refer to the FOPEN and HPFOPEN intrinsics in the MPE/iX Intrinsics Reference Manual (32650-90028). Maximum number of logical records, for new files only. For fixed-length and undefined-length files, the maximum value allowed for this field is 2,147,483,647. Default is 1023.
Command Definition F-K FILE KSAMXL specifies a native mode KSAM file (KSAM XL file). SPOOL specifies an output spool file. No spooling attributes are initialized. PRI is set to 8 and number of copies to 1. No output device is set. This spool file will not be linked to the spool file directory (SPFDIR) and, therefore, will not be printed unless it is subsequently linked to the SPFDIR with the SPOOLF;PRINT command. At that time, the target output device must be set according to the rules of that command.
Command Definition F-K FILE keysize DUP or RDUP Length of the KSAM key, in bytes. This parameter is required for all key types. Different keytypes have different lengths, as described below: BYTE 1 to 255 bytes INTEGER 1 to 255 bytes REAL 1 to 255 bytes IEEEREAL 4, 8, or 16 bytes NUMERIC 1 to 28 bytes PACKED 1 to 14 bytes (odd number of digits) *PACKED 2 to 14 bytes (even number of digits) These two options apply only to KSAM files.
Command Definition F-K FILE Parameters for Access NOCCTL or CCTL Indicates whether or not carriage-control characters are specified. NOCCTL indicates that carriage-control characters are not being specified in writes to the file. CCTL indicates that carriage-control characters are being supplied in writes to the file. Default is NOCCTL. NOMULTI, MULTI, or GMULTI Indicates if the sharing of files in jobs and sessions is allowed. NOMULTI prohibits sharing files in MULTI mode and is the default.
Command Definition F-K FILE formsmsg A message to the operator requesting that certain forms be mounted. The message must be displayed and verified before the output data can be printed on a line printer. The message is a string of no more than 49 ASCII characters terminated by a period. Control characters for bells and inverse video may be sent to the system console using this parameter.
Command Definition F-K FILE formid Applies only to output spoolfiles. A string of up to eight alphanumeric characters, beginning with a letter, which uniquely identifies a special form that is to be mounted. A message displaying this formid is printed on the system console or $STDLIST of the associated user of the spooled device. The spooler process then awaits verification that the special forms have been mounted before printing the file for which the formid was specified.
Command Definition F-K FILE To use the FILE command for a file, you must have a valid, formal file designator (the name by which your program recognizes the file). The formal file designator provides a way for commands and code outside your program to reference the file. The FILE command is the only way you can control or change the programmatic file specifications without changing the code which calls FOPEN or HPFOPEN. Use This command may be issued from a session, a job, a program, or in BREAK.
Command Definition F-K FILE The following is an example of using the *formaldesignator, in this case, specifying a file on magnetic tape used as a source file during FORTRAN compilation: FILE SOURCE=TAPE1,OLD;DEV=TAPE;REC=-80 FTNXL *SOURCE Implicitly, the command executor issues the following FILE command, backreferencing your previous FILE command: FILE FTNTEXT=*SOURCE Implicit FILE commands, like explicit FILE commands, cancel any previous FILE commands that reference the same formal file designators.
Command Definition F-K FINDDIR (UDC) FINDDIR (UDC) The FINDDIR UDC executes the LISTFILE command to search for a directory. NOTE 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 Syntax FINDDIR[ [ DIR=] dir_name] [ [ START=] start_dir] Parameters Refer to the LISTFILE command for a complete explanation of the parameters used with the FINDDIR UDC.
Command Definition F-K FINDFILE (UDC) FINDFILE (UDC) The FINDFILE UDC executes the LISTFILE command to search for a file. NOTE 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 Syntax FINDFILE[ FILE=] filename [ [ START=] start_dir] Parameters Refer to the LISTFILE command for a complete explanation of the parameters used with the FINDFILE UDC.
Command Definition F-K FORMSALIGN FORMSALIGN Configures one spooled printer or a group of spooled printers related by device class, to conditionally enter into a forms message dialog with its operator (s) when the current spoolfile includes a forms message. Syntax FORMSALIGN[DEV=]{ldev | devclass | devname } [;[DIALOG=]{{EACHCHANGE | EACHFILE | EACHCOPY }[,{FORMIDOVERRIDE | NOFORMIDOVERRIDE}]}] [ ;SHOW] Parameters ldev The logical device number of a printer.
Command Definition F-K FORMSALIGN formids match, both the DIALOG option for the spooler process and any forms message in the current spoolfile are ignored, and the forms message dialog is not activated. Identical formids override all other considerations. Note that the DIALOG option is not changed. It is ignored as long as the two formids match.
Command Definition F-K FORMSALIGN NOFORMIDOVERRIDE This is a sub-parameter of the chosen EACHxxx keyvalue. With this feature selected, the Native Mode Spooler ignores any and all formids associated with the current spoolfile or the previous spoolfile. The setting of the DIALOG option always determines the conditions under which the spooler process conducts the forms message dialog. The formid is then useful only as an item in a selection equation.
Command Definition F-K FORMSALIGN This command effects more than one device (if applied to all devices in a class). You may get warning messages for some devices and not others. A warning message on one or more devices affects only that device. The command will continue to execute until all selected devices have been configured or shown, or an error is detected. An error terminates the command. NOTE The options specified in the FORMSALIGN command are stored in the appropriate device files.
Command Definition F-K FORTGO FORTGO Compiles, prepares, and executes a compatibility mode FORTRAN 66/V program. FORTRAN 66/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax FORTGO[ textfile] [ ,[ listfile] [ ,[ masterfile] [ ,[ newfile] ] ] ] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definition F-K FORTGO The USL file created during the compilation is a system-defined temporary file $OLDPASS, which is passed directly to the MPE segmenter, and cannot be accessed. Use 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.
Command Definition F-K FORTPREP FORTPREP Compiles and prepares a compatibility mode FORTRAN 66/V program. FORTRAN 66/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax FORTPREP[ textfile] [ ,[ progfile] [ ,[ listfile] [ ,[ masterfile] [ ,[ newfile] ] ] ] ] [ ;INFO=quo tedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definition F-K FORTPREP NOTE The formal file designators used in this command (FTNTEXT, FTNLIST, FTNMAST, and FTNNEW) 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. Operation Notes This command compiles and prepares a compatibility mode FORTRAN 66/V program into a program file stored on disk.
Command Definition F-K FORTRAN FORTRAN Compiles a compatibility mode FORTRAN 66/V program. FORTRAN 66/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax FORTRAN[ textfile] [ ,[ uslfile] [ ,[ listfile] [ ,[ masterfile] [ ,[ newfile] ] ] ] ] [ ;INFO=quoted string] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definition F-K FORTRAN 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. quotedstring INFO=quotedstring is used to pass initial compiler options to a program.
Command Definition F-K FORTRAN To compile a FORTRAN 66/V program and store the object code into a USL file you create with the BUILD command, enter: BUILD OBJECT;CODE=USL FORTRAN SOURCE,OBJECT,LISTFL To create a USL file with the BUILD command, the code must be specified.
Command Definition F-K FREERIN FREERIN Releases a global resource identification number (RIN). Syntax FREERIN rin Parameters rin The resource identification number (RIN) to be released. It must be a number from one to the configured maximum. Operation Notes A resource identification number is used to manage a resource shared by two or more jobs or sessions so that only one job or session at a time can access that resource. The user acquires a RIN from the system by entering the GETRIN command.
Command Definition F-K FTN FTN Compiles a compatibility mode FORTRAN 77/V program. FORTRAN 77/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 FTNXL. Syntax FTN[ textfile] [ ,[ uslfile] [ ,[ listfile] ] ] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definition F-K FTN 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. You cannot backreference the formal file designators used in this command (FTNTEXT, FTNUSL, and FTNLIST) as actual file designators in the command parameter list.
Command Definition F-K FTNGO FTNGO Compiles, prepares, and executes a compatibility mode HP FORTRAN 77/V program. HP FORTRAN 77/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 the FTNXLGO command. Syntax FTNGO[ textfile] [ ,listfile] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definition F-K FTNGO Use 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.
Command Definition F-K FTNPREP FTNPREP Compiles and prepares a compatibility mode HP FORTRAN 77/V program. HP FORTRAN 77/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 the FTNXLLK command. Syntax FTNPREP[ textfile] , [ progfile] [ ,listfile] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read.
Command Definition F-K FTNPREP Operation Notes The FTNPREP command compiles and prepares a compatibility mode HP FORTRAN 77/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 FTNLIST (default $STDLIST). The USL file $OLDPASS, created during compilation, is a temporary file passed directly to the MPE segmenter.
Command Definition F-K FTNXL FTNXL Compiles an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP FORTRAN 77/iX is installed on your system. (Native Mode) Syntax FTNXL[ textfile] [ ,[ objectfile] [ ,[ listfile] ] ] [ ;INFO=quotedstring] NOTE This command follows the optional MPE/iX command line syntax.
Command Definition F-K FTNXL The info string used in the HP FORTRAN 77/iX programming language to pass initial compiler options to the HP FORTRAN 77/iX compiler. HP FORTRAN 77/iX places a single dollar sign ($) before the info string and places the string before the first line of source code in the text file. NOTE The formal file designators used in this command (FTNTEXT, FTNOBJ, and FTNLIST) cannot be backreferenced as actual file designators in the command parameter list.
Command Definition F-K FTNXL FTN MAIN, SOMEUSL FTN 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.
Command Definition F-K FTNXLGO FTNXLGO Compiles, links, and executes an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP FORTRAN 77/iX is installed on your system. (Native Mode) Syntax FTNXLGO[ textfile] [ ,[ listfile] ] [ ;INFO=quotedstring] NOTE This command follows the optional MPE/iX command line syntax.
Command Definition F-K FTNXLGO Operation Notes The FTNXLGO command compiles, links, and executes an HP FORTRAN 77/iX 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 FTNLIST (default is $STDLIST). The object file created during compilation is a system-defined temporary file, $NEWPASS, which is passed directly to the Link Editor as $OLDPASS.
Command Definition F-K FTNXLLK FTNXLLK Compiles and links an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP FORTRAN 77/iX is installed on your system. (Native Mode) Syntax FTNXLLK[ textfile] [ ,[ progfile] [ ,[ listfile] ] ] [ ;INFO=quotedstring] NOTE This command follows the optional MPE/iX command line syntax.
Command Definition F-K FTNXLLK Operation Notes The FTNXLLK command compiles and links an HP FORTRAN 77/iX program into a disk file. If you do not specify textfile, HP FORTRAN 77/iX expects your input from your standard input device. If you do not specify listfile, HP FORTRAN 77/iX sends the listing output to your current list device. The object file created during compilation is a system-defined temporary file, $NEWPASS, which is passed directly to the Link Editor as $OLDPASS.
Command Definition F-K GETLOG GETLOG Establishes a logging identifier on the system. Syntax GETLOG logid;LOG=logfile{ ;NOAUTO } ] ,DISC ,TAPE ,SDISC ,CTAPE } [ ;PASS=password] [ { ;AUTO Parameters logid The logging identifier to be established. This must contain from one to eight alphanumeric characters beginning with an alphabetic character. logfile The name of the file to receive data from the logging procedure.
Command Definition F-K GETLOG If a log file is restricted to a single volume or volume class when it is created with the BUILD command, then successive log files created by User Logging will have the same restriction. If a new log file name is specified with the ALTLOG command, the links with any previous log file are broken. There cannot be two logging identifiers with the same name on the system at the same time. The LISTLOG command can be used to determine what logging identifiers currently exist.
Command Definition F-K GETRIN GETRIN Acquires a global resource identification number (RIN) and assigns a password to it. Syntax GETRIN rinpassword Parameters rinpassword Password of the intrinsic that locks the RIN. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. Operation Notes The GETRIN command acquires a global RIN from the MPE/iX RIN pool, typically during a session.
Command Definition F-K GETRIN Related Information Commands FREERIN Manuals Resource Management Programmer's Guide 278 Chapter 4
Command Definition F-K HEADOFF HEADOFF Stops header/trailer output to a device. (Native Mode) Syntax HEADOFF ldev Parameters ldev The logical device number of the printer affected by the command. Operation Notes Header and trailer information appears before and after a file when it is printed. This information is not a part of the file's text. This information identifies the file by session number, output spoolfile number, session name (if any), user, and account.
Command Definition F-K HEADON HEADON Resumes header/trailer output to a device. (Native Mode) Syntax HEADON ldev Parameters ldev The logical device number of the printer affected by the command. Operation Notes Header and trailer information appears before and after a file when it is printed. This information is not a part of the file's text. This information identifies the file by session number, output spoolfile number, session name (if any), user, and account.
Command Definition F-K HELLO HELLO Initiates an interactive session. (Native Mode) Syntax HELLO[ sessionname,] username [ /userpass] .acctname [ /acctpass] [ ,groupname[ /grouppass ] ] [ ;TERM={ termtype termname } ] [ ;TIME=cpusecs] [ ;PRI={ BS CS DS ES } ] [ { ;INPRI=inputpriority ;HIPRI } ] [ ;INFO=ciinfo] [ ;PARM=ciparm] Parameters sessionname Arbitrary name used in conjunction with username and acctname parameters to form a fully qualified session identity.
Command Definition F-K HELLO factors for carriage returns. It must be 10 or 18. The default value for termtype is assigned by the system supervisor during system configuration. This is a required parameter to ensure correct listings if your terminal is not the default termtype. The termname parameter is the name of the file containing the desired terminal-type characteristics. The file cannot have a lockword or reside on a user volume.
Command Definition F-K HELLO MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI, MAXIMUM INPRI OF 13 IS USED (CIWARN 1460) ciinfo An INFO string to be passed to the command interpreter. For the MPE/iX CI, it is the first command to be executed by the command interpreter. This parameter replaces the ( ) COMMAND LOGON command and approximates its function. The ( ) COMMAND LOGON command caused the session to terminate after executing the specified command.
Command Definition F-K HELLO When you first access an MPE/iX system to log on, the MPE iX: prompt is displayed. When you log off using the BYE command, the following message is displayed: CPU=1. CONNECT=1. THU, DEC 8, 1994, 1:50 PM The RELEASE: V.UU.FF number in the logon banner is determined by Hewlett-Packard at operating system build time and provides an identity for software releases (also known as the MIT). This number may not be changed. (Prior to MPE/iX release A.11.
Command Definition F-K HELLO home group as your logon group when you log on. But if you want to use some other group as your logon group, you must specify that group's name in your logon command in this way: MPE iX:HELLO USER.TECHPUBS,MYGROUP If your user name is not related to a home group, you must enter a group name in your HELLO command, or your logon attempt is rejected.
Command Definition F-K HELLO Example When you initially log on to access MPE/iX, the system prompt appears as: MPE iX: When you subsequently log on to another account or group, the system prompt by default is a colon (unless you have altered it with the SETVAR HPPROMPT command) and appears as: : To start a session named ALPHA, with the user USER, the account TECHPUBS, the group XGROUP, and the group password XPASS, enter: MPE iX:HELLO ALPHA,USER.TECHPUBS,XGROUP/XPASS HP3000 Release: X.50.
Command Definition F-K HELP HELP Accesses the help subsystem (Native Mode) Syntax Direct access: HELP[ { udcname commandname[ { keyword ,ALL } ] commandfilename errormessage programfilename function name variable name SUMMARY CLASS HELPSTUDY EXPRESSIONS| VARIABLES | OPERATORS | FUNCTIONS } ] Interactive (subsystem) access: >commandname{ space or comma} [ { keyword ,ALL } ] HELPMENU SUMMARY CLASS HELP HELPSTUDY Parameters If you specify the HELP command with no parameters, you enter the help fa
Command Definition F-K HELP variable name commandfilename errrormessage PARMS PARMS is short for parameter. Lists all parameters of the specified command. OPERATION Describes the use of the specified command. EXAMPLE Displays an example showing usage of the specified command. ALL Displays all parameters, operation information, and an example of the command. Any CI predefined variable, eg: HPLASTJOB Any existing command file. Refer to commandname, "Operation Notes," and "Examples.
Command Definition F-K HELP Enter the HELP command without specifying any parameters to invoke HELP as a subsystem. You will see the first screen of Help, called HELPMENU. It lists the choices available to you so that you can review the operation of Help and get a brief overview of the changes found in the MPE/iX operating system.
Command Definition F-K HELP Do not precede the command or item name with HELP, or you will get an error message. For example: :HELP >HELP FINFO ^ Can't find this keyword. To exit the Help Subsystem, enter E or EXIT' or press Break. To stop the display and return to a system prompt, enter CTRL Y. temporarily stops the display, enter CTRL S. Use CTRL Q to resume.
Command Definition F-K HELP At the Help facility prompt (>), simply type the variable name, for example, "HPCIDEPTH". Global Variable Types ================================================================= R READ ONLY variable (cannot be modified). W READ/WRITE variable (can be modified). JCW A standard MPE/iX JCW. I Integer format. B Boolean format (TRUE/FALSE). (24/225) Continue? If LINKALL is a command file, HELP displays the file as follows: HELP LINKALL.TEST.UI User-Defined Command File:LINKALL.TEST.
Command Definition F-K IF IF Used to control the execution sequence of a job, UDC, or command file. (Native Mode) Syntax IF expression[ THEN] Parameters expression Logical expression, consisting of operands and relational operators. The operators listed in Table 4-1 may be incorporated in expression.
Command Definition F-K IF Operation Notes This command begins an IF block consisting of all the commands after the IF command up to, but not including, the next ELSE. ELSEIF, or ENDIF statement. The ELSE, ELSEIF, or ENDIF must have the same nesting level as the IF statement. Another similar block can follow the ELSE statement. Nesting of the blocks is allowed to 30 levels so long as IF is used alone. In a case where IF is used with WHILE the total nesting of IF and WHILE blocks cannot exceed 30 levels.
Command Definition F-K INPUT INPUT Permits the user to assign a value interactively to any variable that could otherwise be set with the SETVAR command. The user may also create an optional prompt string and have it displayed on $STDLIST before the value is read. (Native Mode) Syntax INPUT[ NAME=] NOTE varname [ ;PROMPT=prompt] [ ;WAIT=seconds] [ ;READCNT=chars] This command follows the optional MPE/iX command line syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning of this chapter.
Command Definition F-K INPUT INPUT reads a value from the standard input device ($STDIN) and stores it as a string in the variable named varname. If varname does not exist, INPUT creates it. If prompt is omitted, nothing is displayed, and INPUT waits for an input value to store in varname. The variable varname can be used as you would use any other MPE/iX string variable. CI input redirection can be used to set varname to a record in a file.
Command Definition F-K INPUT The first command reads whatever value you enter and sets bleep to the string representation of that input. The second command assigns bleep the (evaluated) value that you entered. INPUT MYVAR
Command Definition F-K JOB JOB Defines a job to be activated with the STREAM command or an input spooled device to run in batch mode. (Native Mode) Syntax JOB[ jobname,] username [ /userpass] .
Command Definition F-K JOB • Neither $STDIN nor $STDLIST is redirected. • The JOB command is a first level JOB command (it is not nested within a second level STREAM command). If the password is supplied in the command syntax it must be preceded by a slash (/). queuename The name of the job queue the job will execute in.
Command Definition F-K JOB For information on the guidelines for these priority queues, refer to the TUNE command in this chapter. inputpriority or HIPRI Determines the input priority of the job. The inputpriority parameter is the relative input priority used in checking against access restrictions imposed by the jobfence. The inputpriority parameter takes effect at logon time and must be from 1 (lowest priority) to 13 (highest priority).
Command Definition F-K JOB This parameter applies only to output destined for spooled output devices, and is ignored for other output. Default is 8. numcopies Number of copies of job listing to be produced. This parameter applies only when listing is directed to a spooled device, and is ignored in other cases. If the number of copies is less than 1, a warning is issued. The command still executes with the default value of 1.
Command Definition F-K JOB rather than the originating diskfile (in the case of the STREAM command) or device (in the case of the input spooled device). If the standard listing file is a line printer, MPE/iX prints a header page prior to listing the JOB command. (The system operator can disable the printing of this header page with the HEADOFF console command.) The job number assigned by MPE/iX always uniquely identifies your job to MPE/iX and other users.
Command Definition F-K JOB RUN EDITOR.PUB.SYS /ADD 1 !JOB WXYZ,WRITER.TEC 2 !EDITOR 3 TEXT ABC 4 LIST ALL,OFFLINE 5 EXIT 6 !EOJ // /KEEP MYJOB /EXIT : STREAM MYJOB The following example shows using the JOB command in interactive mode with the STREAM command: STREAM >!JOB USER.
Command Definition F-K JOBFENCE JOBFENCE Defines the minimum input priority that a job or session must have in order to execute. (Native Mode) Syntax JOBFENCE priorityfence Parameters priorityfence A number between 0 and 14, inclusive. Within this range, smaller numbers are less limiting; larger numbers more limiting.
Command Definition F-K JOBFENCE JOBFENCE 6 16:21/#J7/34/LOGON FOR: JOB1,FIELD.SUPT ON LDEV #10 16:21/#J8/35/LOGON FOR: JOB2,FIELD.
Command Definition F-K JOBPRI JOBPRI Sets or changes the default execution priority for batch jobs and sets a maximum execution priority for batch jobs. (Native Mode) Syntax JOBPRI[ maxsubqueue] [ ,defaultsubqueue] Parameters maxsubqueue The maximum priority at which batch jobs are allowed to run. This overrides any job priority a user may have requested with the JOB command. This parameter may be ES, DS, CS, or zero. If zero is specified, no limit is imposed on batch jobs.
Command Definition F-K JOBSECURITY JOBSECURITY Designates what level of user may request resources and control the execution of jobs. (Native Mode) Syntax JOBSECURITY[ { HIGH LOW } { ;PASSEXEMPT= { NONE} ,{ USER} ,{ XACCESS} ,{ MAX} } ] Parameters HIGH Permits only the operator logged on at the console and users with SM capability to use job control commands. LOW Allows individual users to exercise control over their own jobs.
Command Definition F-K JOBSECURITY it is set to LOW, any user may issue these commands for their own jobs (i.e., those where the job's user name and account matches the user's) and Account Managers may control the execution of any job in their account. System managers may use the PASSEXEMPT parameter of the JOBSECURITY command to control password validation when users stream a job.
Command Definition F-K JOBSECURITY If the HP Security Monitor is installed with both stream privilege and authorization turned on, the JOBSECURITY command will display a warning when the output produces a different result. :JOBSECURITY ;PASSEXEMPT=USER Security Monitor is installed. Passexempt is MAX.
Command Definition F-K LDISMOUNT LDISMOUNT Cancels a previously issued LMOUNT or VSRESERVE command. This informs the system that the volume set is no longer reserved system-wide. The equivalent native mode command is VSRELEASESYS. (Native Mode) Syntax LDISMOUNT[ { * | | volumesetname } ] [ ,groupname[ .acctname] ] Parameters * or Specifies the home volume set for the group and account specified, or for the logon group and account if groupname or groupname.acctname is not specified.
Command Definition F-K LDISMOUNT *.grp.acct. The home volume set of the group grp in account acct. Causes an error. myset_grp_acct Error (name component longer than eight characters). The volume set named myset_grp_acct. m_g_a The volume set named m_g_a.logongrp.logonacct, provided it exists. If it does not exist, an error is reported. The volume set name m.g.a. In MPE V/E, the name V.G.
Command Definition F-K LDISMOUNT Related Information Commands MOUNT, , LMOUNT, DISMOUNT, DSTAT, VSRESERVE, VSRELEASE Manuals Volume Management Reference Manual Chapter 4 311
Command Definition F-K LIMIT LIMIT Limits the number of concurrently running jobs/sessions. (Native Mode) Syntax LIMIT[ { [+ | - ] numberjobs [+ | - ] ,numbersessions | numberjobs,numbersessions ] [;JOBQ=queuename] Parameters + Increment the limit value - Decrement the limit value numberjobs The number of jobs. numbersessions The number of sessions. If you specify no parameter, a message is displayed listing the current limits.
Command Definition F-K LIMIT Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. It may be issued only from the console unless distributed to users with the ALLOW command. Examples To limit the number of jobs to 2 and the number of sessions to 15, enter: LIMIT 2,15 SHOWJOB JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME #S24 #S26 #S96 EXEC 20 20 TUE 1:54A OPERATOR.SYS EXEC 177 177 TUE 5:01A CHEWY,RSPOOL.
Command Definition F-K LINK LINK Creates an executable program file by merging the relocatable object modules from all the files in its FROM= parameter. Those files may correspond to object files, relocatable files, or a combination of them. It also searches any relocatable libraries mentioned in the RL= parameter list and merges any modules within those libraries that resolve an external reference. (Native Mode) Syntax LINK[ FROM=file[ ,file...] [ ;TO=destfile] ] [ ;RL=rlfile[ ,rlfile...]...
Command Definition F-K LINK If a module from one library calls a routine in another library and then that routine in turn refers to a module in the first library, you may need to include the first library twice so that LINK can resolve this “circular“ reference. The FROM=, RL=, and XL= parameters allow a series of file names. You may name each file individually, or you may provide an indirect file by preceding that file's name with the caret symbol (^).
Command Definition F-K LINK Table 4-4 Checklevel Values 0 No parameter check. 1 Check of the symbol type descriptor. 2 Perform Level 1 checking, then check the number of arguments that the import procedure passed against the minimum and maximum range that were declared in the export procedure. 3 Perform Level 2 checking, then check the type of each argument that was passed. entryname The name (label) of the point within a program where execution begins.
Command Definition F-K LINK SHARE Specifies that data symbols should be exportable and importable (shared) in the resulting executable library. Operation Notes The Link Editor uses $STDINX, $STDIN, and $STDLIST as standard files. The Link Editor reads its commands from $STDINX. For interactive sessions this is the terminal keyboard. For a batch job, it is the job stream file. You can redirect $STDINX to another file. The file must be an unnumbered ASCII file containing valid HP Link Editor/iX commands.
Command Definition F-K LINK Use This command may be issued from a session, job, or program, but not in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples This command merges the object modules from the OBJCODE and places them into the program EXECPROG. It assigns a program stack of 50,000 bytes and requests LINK to build a map and display the name of each object module as it is being linked.
Command Definition F-K LISTACCT LISTACCT Displays information about one or more accounts. Syntax LISTACCT[ acctset] [ ,listfile] [ ;PASS] [ ;FORMAT={ SUMMARY|BRIEF|DETAIL} ] Parameters acctset The accounts to be listed. The default is all accounts for system managers (SM). For all other users, the default is their logon account. Use the # symbol to specify a single numeric character. Use the ? symbol to specify a single alphanumeric character.
Command Definition F-K LISTACCT Examples The presence of the password in the following display implies that the user has account manager (AM) capability and this is the user's account, or that the user has system manager (SM) capability and this is not the user's account. LISTACCT HPXLII;PASS ...or...
Command Definition F-K LISTDIR (UDC) LISTDIR (UDC) The LISTDIR UDC executes the LISTFILE command to list all files that are directories. 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.
Command Definition F-K LISTDIR (UDC) Related Information Commands LISTFILE, FINDDIR (UDC) Manuals None 322 Chapter 4
Command Definition F-K LISTEQ LISTEQ Displays all active file equations for a job or session. Syntax LISTEQ[ listfile] Parameters listfile The name of the output file. The default is $STDLIST, a temporary file that cannot be overwritten by a BUILD command. It is automatically specified as a new ASCII file with variable-length records, closed in the temporary domain, and with user-supplied carriage-control characters (CCTL), OUT access mode, and EXC (EXCLUSIVE access) option.
Command Definition F-K LISTF LISTF Displays information about one or more permanent files. (CM) Syntax LISTF[ fileset] [ ,listlevel] [ ;listfile] Parameters fileset Specifies the set of files to be listed. The default is @, which lists all files in your logon group. You may select the file(s) to be listed by using the fully or partly qualified form for fileset: filename.groupname.
Command Definition F-K LISTF Listlevel 2 Displayed Information Displays the file name, file code, record size, file type, current end-of-file location, and the maximum number of records allowed in the file. It also displays the blocking factor, number of sectors in use, number of extents currently allocated, and the maximum number of extents allowed.
Command Definition F-K LISTF Listlevel listfile Displayed Information 7 Shows all file specific data in LISTFILE,5 type format, but does not show LISTFILE,3 data. If a file has no unique data, only the file name is displayed. 8 Shows all accessors of the files listed. Restrictions apply 9 Shows level 8 information and details about processes accessing the files including file locking data. Restrictions apply. The name of the output file to which the file information will be written.
Command Definition F-K LISTF You may have the information displayed on a device other than the standard listing device. To do that, you will need to name the device with a FILE command and then backreference the file in the LISTF command. For example: :FILE PRTR;DEV=LP :LISTF @.@,2;*PRTR Use The LISTF command is available from a session, job, or a program, or in BREAK. Pressing Break aborts the execution of this command.
Command Definition F-K LISTF DISC DEV # 3 CLASS DISC SEC OFFSET 0 VOLSET or VOLNAME or VOLCLASS CLASS : DISC ACCESSED FRI, 21 SEP 1986, 12:46 PM LABEL ADDR ** MPEXL_SYSTEM_VOLUME_SET MPEXL_SYSTEM_VOLUME_SET: MEMBER1 MPEXL_SYSTEM_VOLUME_SET: DISC LABEL ADDR: $00000010 $0010E014 Level 6 File Display :LISTF L@,6 LINKCLK.DEVELOP.HPXLII LINKFROG.DEVELOP.HLPXLII LINKLIST.DEVELOP.HPXLII Level 7 File Display ******************** FILE: LINKCLK.DEVELOP.HPXLII ******************** FILE: LINKFROG.DEVELOP.
Command Definition F-K LISTF ACCESS: R-excl LOCKSOwner Waiter OPEN FLOCK REC#: 336 FNUM: 15 Level -2 File Display FILENAME ACD ENTRIES DOCMNTS NO ACDS Level -3 File Display :LISTF DOCMNTS,-3 ******************** FILE DOCMNTS.DEVELOP.
Command Definition F-K LISTF 00010405 0EA78B32 000000A0 00009C90 00100000 00000000 00020CEE 000001F5 00000000 00190007 00000300 12F61E2D 00000000 00000000 000F0000 00020CEE 00020CEE 00000000 00000000 20200000 0EA78B32 0EA78B32 00000000 00000050 00020CEE .......H........ 00000000 ................ 00000000 ........... .. 00000500 ................ C.8x@.R.@.Q.......
Command Definitions L-O 5 Command Definitions L-O Chapter 5 331
Command Definitions L-O LISTFILE LISTFILE This command lists file and directory attributes through the use of options. The LISTFILE information is a superset of the LISTF command information. Syntax LISTFILE[ [ fileset=] { fileset (fileset[ ,fileset] ...) } ] [ [ ;FORMAT=] format_opt] [ [ ;SELEQ=] select_eq | ^indir] [ [ ;NAME=] pattern] [ ;PASS] [ ;{ PERM} { ;TEMP} [ ;PERMTEMP] ] [ ;USENAME] [ ;TREE] [ ;NOTREE] Parameters fileset Specifies the set of files to be listed.
Command Definitions L-O LISTFILE For example, "[a-c]" means one of ‘a', ‘b', or ‘c', whereas "[-a-c]" or "[a-c-]" means one of ‘a', ‘b', ‘c', or ‘-'. It is illegal to specify [c-a], or [a-A] because ‘c' does not alphabetically precede ‘a' and uppercase ‘A' comes before lowercase ‘a' (in ASCII character evaluation). Also note that it is legal to specify [A-z] and any legal special characters.
Command Definitions L-O LISTFILE If fileset ends in a slash, it is treated as a directory name, and pattern is used to determine the file names that match. All the directories and files that match fileset are found, and searched recursively to display the files and directories that match pattern. For example, if fileset is /SYS/@/, all files and subdirectories within SYS, and all files and directories within those subdirectories are displayed. The default for pattern is @.
Command Definitions L-O LISTFILE Opti on Name Displayed Information 1 SUMMARY Displays the file name, file code, record size, record format, and other file characteristics such as ASCII or binary records, carriage-control option, file type, current end-of-file location, and the maximum number of records allowed in the file. 2 DISC Displays the file name, file code, record size, file type, current end-of-file location, and the maximum number of records allowed in the file.
Command Definitions L-O LISTFILE Opti on Name Displayed Information 7 UNIQUE Shows all file specific data in LISTFILE,5 type format, but does not show LISTFILE,3 data. If a file has no unique data, only the file name is displayed. Default = 0 (FILES). 8 ACCESS Shows all accessors of the files listed. Restrictions apply. 9 LOCKS Shows level 8 information and details about processes accessing the files including file locking data. Restrictions apply. select_eq A selection equation.
Command Definitions L-O LISTFILE pattern MNEMONIC List only files matching the specified file code mnemonic PRIV List only files with negative file code. INUSE Lists only files that are currently in use by users or by MPE. OPEN Lists only files that are opened by progams. INUSE is a superset of OPEN. LOCK List only files being locked by a program.
Command Definitions L-O LISTFILE the files at the specified level are displayed. For example, /@/@/@ indicates that all objects at the third level are to be displayed. USENAME is the default. TREE If the TREE option is specified, objects at all lower directory levels are displayed. NOTREE Indicates that only objects at the specified level are to be displayed. The NOTREE option overrides an HFS fileset that ends in a slash.
Command Definitions L-O LISTFILE FILENAME CODE LOGICAL RECORD- SPACE SIZE TYP EOF LIMIT R/B SECTORS #X MX F4 80B AF 411 411 16 144 2 * F5 80B AF 199 199 16 64 1 * HFS Examples The following figure illustrates a hierarchical directory structure. In this figure, directory names are shown as the character d plus a number (for example, d0), and file names are shown as the character f plus a number (for example, f1). The examples assume the directory structure shown.
Command Definitions L-O LISTFILE In the next example, specifying the absolute pathname produces a listing of all entries one level below the group. /ACCT/GROUP/d0:listfile /ACCT/GROUP/@,2 PATH= /ACCT/GROUP/ CODE LOGICAL RECORD- SPACE FILENAME SIZE TYP EOF LIMIT R/B SECTORS #X MX 16W HBD 4 67107839 1 64 2 * *d0/ In the next example, specifying the NAME parameter produces a listing of all entries with names beginning with a lower case "d".
Command Definitions L-O LISTFILE The next example illustrates the use of the OBJECT=DIR parameter to show all directories on the system. This is similar to the FINDDIR UDC.
Command Definitions L-O LISTFILE NUM EXT: 2 EXECUTE : MAX REC: 67107839 **SECURITY IS ON FLAGS : NO ACCESSORS NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 2:20 PM MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:23 PM DISC DEV #: 1 ACCESSED: WED, JUL 22, 1992, 12:05 PM SEC OFFSET: 0 LABEL ADDR: ** VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC ******************** . . .
Command Definitions L-O LISTFILE LOCK : EXECUTE : GROUP READ : WRITE : APPEND : LOCK : EXECUTE : SAVE : FILE - READ : FCODE: 0 WRITE : **SECURITY IS ON APPEND : ACD EXISTS LOCK : EXECUTE : FOR MANAGER.ACCT: RACD, TD, RD, CD, DD The next example illustrates the use of the FORMAT=-2 (ACD) option to display the access contol definition (ACD) for file f4 in subdirectory d2. Note that all users (@.@) have read ACD (RACD) access for this file. /ACCT/GROUP/d0:listfile .
Command Definitions L-O LISTFTEMP LISTFTEMP Displays information about one or more temporary files. Syntax LISTFTEMP[ fileset] [ ,listlevel] [ ;listfile] Parameters fileset Specifies the set of temporary files to be listed. The default is @, producing a listing of all temporary files. You may select the temporary file(s) to be listed by using the fully qualified form for fileset: filename[.groupname[.accountname]] Use the # symbol to specify a single numeric character.
Command Definitions L-O LISTFTEMP Option Displayed Information 3 −3 Displays the file name, record size, extent size, number of records, user's access rights, and other file characteristics including the date created, modified, and last accessed. The same information for MPE and HFS files is displayed except for the following differences: • Fully qualified MPE file name is replaced by an absolute pathname. • Creator field displays the fully qualified user ID (user.acct) of the file owner.
Command Definitions L-O LISTFTEMP The name of the output file. The default is $STDLIST. If you specify listfile, it is automatically created as a new ASCII file with variable-length records, closed in the temporary domain, and with user-supplied carriage-control characters (CCTL), OUT access mode, and EXC (EXCLUSIVE access) option. All other characteristics are the same as they would be with the FILE command default specifications.
Command Definitions L-O LISTFTEMP BLK FACTOR: 16 CREATOR: REC SIZE: 80(BYTES) LOCKWORD: BLK SIZE: 640(BYTES) SECURITYREAD :ANY EXT SIZE: 25(SECT) WRITE :ANY NUM REC: 501 APPEND :ANY NUM SEC: 165 LOCK :ANY NUM EXT: 7 EXECUTE:ANY MAX RED: 501 **SECURITY IS ON MAX EXT: 7 FLAGS: n/a NUM LABELS: 0 CREATED: FRI, 21 SEP 1986, 11:55 AM MAX LABELS: 0 MODIFIED: FRI, 21 SEP 1986, 12:34 PM DISC DEV #: 3 ACCESSED: FRI, 21 SEP 1986, 12:46 PM SEC OFFSET: 0 VOLSET : MPEXL_SYSTEM_VOLUME_SET or VOLNAME : MPEXL_SYSTEM_VOLUME_
Command Definitions L-O LISTGROUP LISTGROUP Displays information for one or more groups. Syntax LISTGROUP[ groupset] [ ,listfile] [ ;PASS] [ ;FORMAT={ SUMMARY|BRIEF|} ] Parameters groupset Specifies the set of groups to be listed. For account managers (AM) and system managers (SM), the default is all (@) groups within the user's logon account; for general users, the default is the logon group. You may use wildcard characters to specify more than one group.
Command Definitions L-O LISTGROUP Example In the following example, since the user does not have AM or SM capability, the password does not appear in the display. LISTGROUP DEVELOP;PASS;FORMAT=SUMMARY ******************* GROUP: DEVELOP.
Command Definitions L-O LISTJOBQ LISTJOBQ LISTJOBQ lists all available job queues in the system. Syntax LISTJOBQ Parameters none Operation Notes The LISTJOBQ command allows the user to list all the existing job queues in the system. It displays the queue name, limit, number of jobs in the queue that are in the EXEC state and the total number jobs in the queue, Number of jobs in the EXEC state plus number of jobs in the WAIT state). This command is not allowed in the SYSSTART file.
Command Definitions L-O LISTLOG LISTLOG Lists currently active logging identifiers on the system and whether automatic log file changing has been enabled. Syntax LISTLOG[ logid[ ;PASS] ] Parameters logid The specific logging identifier to be verified. Default is to list all currently active logging identifiers on the system. PASS Causes the password associated with the logging identifier to be displayed. This option can be used only by the creator of the logging identifier.
Command Definitions L-O LISTLOG Related Information Commands ALTLOG, CHANGELOG, GETLOG, LOG, OPENLOG, SHOWLOGSTATUS, RELLOG Manuals User Logging Programmer's Guide (32650-60012) 352 Chapter 5
Command Definitions L-O LISTREDO LISTREDO Displays the contents of the command line history stack. You may specify the format in which the listing appears, and whether it appears on $STDLIST or in a file. (Native Mode) Syntax LISTREDO[ START=m] [ ;END=n] [ ;OUT=outfile] [ ;{ NOTE ABS REL UNN } ] This command follows the optional MPE/iX command line syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning of this chapter.
Command Definitions L-O LISTREDO UNN Suppresses numbering of the commands during display. outfile Sends the listing to a disk file named outfile instead of to the default, $STDLIST. New disk files are created TEMP. File equations are ignored, unless outfile is preceded by an asterisk (*). You must use a file equation to overwrite a permanent file. Operation Notes The LISTREDO command displays the contents of the REDO command line stack.
Command Definitions L-O LISTSPF LISTSPF Produces a listing of input and output spooled files. (Native Mode) Syntax LISTSPF[ [ IDNAME=] { spoolid (spoolid[ ,spoolid] ...) } ] [ [ ;SELEQ=] { ^indirect_file } ] [ ;DETAIL ;STATUS ] NOTE select-eq This command follows the optional MPE/iX command line syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning of this chapter. Parameter Definitions spoolid One or more spool file IDs: #Innn for input spool files or #Onnn for output spool files.
Command Definitions L-O LISTSPF If you are not an SM, OP, AM, or console user, the following command displays all the output files in your default group with a priority greater than 2 that were created before September 30, 1994. LISTSPF O@;SELEQ=[(PRI>2)AND(DATE<09/30/94)] Selection equations have the following format. The symbol ::= should be interpreted as "can be replaced by".
Command Definitions L-O LISTSPF • parm ::= PAGES: Number of pages in the spool file (if known). A positive integer number is expected. This attribute does not apply to input spool files; therefore, any logical condition involving the attribute always returns FALSE when tested against an input spool file. • parm:= FORMID: Form name. You can use wildcards. (The formid is an ASCII string up to 8 characters, the first of which must be a letter.).
Command Definitions L-O LISTSPF You may use some wildcards; J@ accepts all jobs, S@ accepts all sessions. J'@ and S'@ are also allowed, The apostrophe (') indicates an imported spool file or a spool file recovered during START NORECOVERY. • parm ::= RECS: Number of records in the spool file. A positive integer is expected. • parm ::= OWNER: The user under which the spool file was created. The format of the owner is user.account. If the account is not specified, the user's current account is assumed.
Command Definitions L-O LISTSPF • This process repeats until either 509 characters have been counted or the end-of-file is detected. Records terminating with or without ampersands may be mixed as desired in the indirect file. • If the resulting string is ≤509 characters, it is parsed. • If the parser detects a syntax error, or if any non-blank character follows the closing bracket (]) of the select-eq, an error is returned and the select-eq is not processed.
Command Definitions L-O LISTSPF Display Field and Description Below is an example of the first line of the display for LISTSPF. Following the example is a description of each field in the display. SPOOLID #01 JOBNUM FILEDES PRI J12345 $STDLIST 6 COPIES DEV 1 EPOC STATE RSPFN CREATE RSPFN OWNER THISUSER.ACCOUNT1 SPOOLID The unique spool file identifier. JOBNUM The job or session identifier of the job or session that created the spool file.
Command Definitions L-O LISTSPF before printing the trailer of its current one. (This is required to manage headers and trailers properly). Also note that you see only one file in the PRINT state during a trailer if the next file is another copy of the current file. • DEFER: An output spool file is in the deferred state. • SPSAVE: The SPSAVE option was specified when the spool file was created or at any time before it would have been deleted after its final copy was printed.
Command Definitions L-O LISTSPF This is the fully qualified name of the creator of the spool file. OWNER Below is an example of the optional second line of the display, followed by an explantion of each display field. FORMID JOBNAME TESTJOB COPSRM 1 250 SECTS 500 RECS ~9 PAGES 12/20/88 DATE TIME 8:39 FORMID An 8-character display, the first of which is a letter.
Command Definitions L-O LISTSPF • The itemized count of spool files in each of the various states. They are shown in two groups, input spool files to the left of the display and output spool files to the right. Of these, only SELECTED is not a state. Instead, SELECTED shows the total count of spool files whose output priority is higher than the global outfence; that is, SELECTED displays the sum of printing files plus those READY files whose output priority is above the global outfence.
Command Definitions L-O LISTSPF #O1233 S1234 OUTLIST 0 1 FASTLP TESTJOB 1 250 500 DEFER DEV.HPE ~9 12/20/88 8:39 #I564 READY DEV.
Command Definitions L-O LISTUSER LISTUSER Displays information for one or more users. Syntax LISTUSER[ userset] [ ,listfile] [ ;PASS] [ ;FORMAT={ SUMMARY|BRIEF|DETAIL} ] Parameters userset Specifies the set of users to be listed. The default is all (@) users (and accounts) within the user's capabilities (AM or SM). Use wildcard characters to specify more than one user. Use the ? symbol to specify a single alphanumeric character. Use the # symbol to specify a single numeric character.
Command Definitions L-O LISTUSER LISTUSER PETE;PASS ...or... LISTUSER PETE;PASS;FORMAT=SUMMARY ******************* USER: PETE.TEST HOME GROUP: DEVELOP PASSWORD: MYPASS MAX PRI : 150 LOC ATTR: $00000000 LOGON CNT : 1 WRITE : GU CAP: AM,AL,GL,DI,CV,UV,LG,CS,ND,SF,IA,BA,PH,DS,MR,PM LISTUSER @;FORMAT=BRIEF PETE.TEST MIKE.TEST CHRIS.TEST LISTUSER PETE;FORMAT=DETAIL ******************* USER : PETE.
Command Definitions L-O LMOUNT LMOUNT Requests a logical reservation of a volume set. This informs the system that the volume set is to be reserved system-wide. The equivalent native mode command is VSRESERVESYS. (Native Mode) Syntax LMOUNT[ { * volumesetname } ] [ .groupname[ .acctname] ] [ ;GEN=[ genindex] ] NOTE For the MOUNT, DISMOUNT, LDISMOUNT, and LMOUNT commands a volume set name such as V.G.A can have no more than eight characters in any part of the name.
Command Definitions L-O LMOUNT If the mountable volumes facility was enabled with VMOUNT ON,AUTO, MPE/iX automatically attempts to satisfy the mount request; the LMOUNT succeeds if the specified volume set is physically connected to the system. If the mountable volumes facility was enabled with VMOUNT ON (omitting the AUTO parameter), you must reply to your own mount request, even though the volume set may already be mounted and in use. Volume sets in MPE/iX are not tied to groups and accounts.
Command Definitions L-O LMOUNT However, VSRESERVE V succeeds only if there is a volume set V in existence. The MPE/iX commands does not call up any default specifications for group and account. VSRESERVE V.G.A succeeds only if a volumeset V.G.A is online. With MPE/iX VSxxxxxx commands, the .G.A component of this name is interpreted as a string, neither more nor less specific than _G _A. If a volume set is named according to the MPE V/E naming convention (V.G.
Command Definitions L-O LOG LOG Starts, restarts, or stops user logging. Syntax LOG logid{ ,RESTART ,START ,STOP } Parameters logid Logging identifier previously established with a user GETLOG command. START Initiates a logging process. RESTART Restarts a logging process. STOP Terminates a logging process. Operation Notes This command allows you to start, restart, or stop user logging. For further discussion of user logging, refer to the User Logging Programmer's Guide (32650-60012).
Command Definitions L-O =LOGOFF =LOGOFF Aborts all executing jobs/sessions and prevents any further logons. You may optionally specify one job or one session that is to remain logged on. Syntax =LOGOFF[ #Snnn] or =LOGOFF[ #Jnnn] Parameters #Snnn or #Jnnn The number of the session or the job that is to remain logged on after all others are aborted. Default is that all sessions and all jobs are logged off.
Command Definitions L-O =LOGOFF CTRL A =LOGOFF #S1 =LOGON LIMIT 0,0 JOBFENCE 0 This logs off all users except #S1 and allows only users with system manager (SM) and system supervisor (OP) capability to log on. It is assumed here that the console operator controls #S1.
Command Definitions L-O =LOGON =LOGON Enables job/session processing following a =LOGOFF command. Syntax =LOGON Parameters None. Operation Notes This command enables the processing of jobs/sessions following the execution of the =LOGOFF command. The =LOGON command reestablishes the job/session limits that were in effect before the execution of a =LOGOFF command and allows jobs/sessions to log on again. Use This command may be issued from a session, program, or in BREAK, but not from a job.
Command Definitions L-O MOUNT MOUNT Sends a request to the system to reserve a volume set (keep it online). The set must be online in order to have the command take effect. (Native Mode) Syntax MOUNT[ { * volumesetname } ] [ .groupname[ .acctname] ] [ ;GEN=[ genindex] ] Parameters * or Specifies the home volume set for the group and account specified, or for the logon group and account if groupname or groupname.acctname is not specified.
Command Definitions L-O MOUNT Table 5-5 Command Acceptance of Naming Conventions - MOUNT Command Specify MPE V/E xxxMOUNT Command Accesses MPE/iX VSxxxxxx Command Accesses myset.grp.acct The volume set named myset.grp.acct. The volume set named myset.grp.acct. myset The volume set named myset.logongrp.logonacct. The volume set myset. *.grp.acct The home volume set of the group grp in account acct. Causes an error. myset_grp_acct Error (name component longer than eight characters).
Command Definitions L-O MOUNT It is recommended that you not use the MPE V/E naming convention and xxxMOUNT commands. Instead use the MPE/iX naming convention and VSxxxxxx commands. Alternating between MPE V/E and MPE/iX commands may lead to errors. For example, MOUNT X used in a job stream attempts to access a volume set named X.logongrp.logonacct, which may or may not be your intention. Use This command may be issued from a session, job, program, or in BREAK.
Command Definitions L-O NEWACCT NEWACCT Creates a new account with an associated account manager and PUB group.
Command Definitions L-O NEWACCT cpu Limit on total CPU-time, in seconds, for this account. This limit is checked only when a job or session is initiated, and so the limit never causes the job or session to abort. The maximum value you may define with NEWACCT is 2,147,483,647 seconds. Default is that no limit is assigned. connect Limit on total session connect-time, in minutes, allowed the account. This limit is checked at logon, and when the job or session initiates a new process.
Command Definitions L-O NEWACCT The default is no security restrictions at the account level. Two or more user types may be specified if they are separated by commas. subqueuename CAUTION The name of the subqueue of highest priority that can be requested by any process of any job/session in the account. This parameter is specified as AS, BS, CS, DS, or ES. Processes capable of executing in the AS or BS subqueues can deadlock the system.
Command Definitions L-O NEWACCT Specifies that users of the account may or may not have passwords. This is the default. It is available only if the HP Security Monitor has been installed. OPT Operation Notes The NEWACCT command may be executed only by the System Manager. The System Manager is responsible for establishing the accounting structure best suited to the computer installation.
Command Definitions L-O NEWACCT The second command connects the accounting structures established on the system volume and on the volume set. By default, however, the PUB group of this account is on the system volume set. To place the PUB group on the volume set MY_VOL, you need to use the PUB parameter in the first command: NEWACCT DOCTOR,WHO;CAP=IA,BA,SF,ND,GL,AM,AL NEWACCT DOCTOR,WHO;ONVS=MY_VOL ALTGROUP PUB.
Command Definitions L-O NEWDIR NEWDIR Creates a directory. (Native Mode) Syntax NEWDIR[ DIR=] dir_name [ ;SHOW | NOSHOW] Parameters dir_name The name of the directory that you are creating (required). The dir_name is assumed to be an MPE name unless it begins with a a dot (.) or a slash (/), which indicates an HFS directory. The dir_name may not end in a slash, have wildcard characters, or reference a file equation. SHOW Echoes the absolute pathname of the newly created directory to $STDLIST.
Command Definitions L-O NEWDIR Examples In the following two examples, a user creates a directory called DIR1. In the first example, the full pathname of the directory is specified in all uppercase since HFS syntax is case-sensitive. In the second example, the user enters the information in lower case using the MPE syntax dir_name.groupname.acctname. (Any case-lower-, mixed-, or uppercase could be used since the CI will automatically shift pathnames entered in MPE syntax to uppercase.
Command Definitions L-O NEWGROUP NEWGROUP Creates a new group within an account. Syntax NEWGROUP groupname [ .acctname] [ ;PASS=[ password] ] [ ;FILES=[ filespace] ] [ ;CPU= [ cpu] ] [ ;CONNECT=[ connect] ] [ ;CAP=[ capabilitylist] ] [ ;ACCESS=[ (fileaccess)] ] [ ;ONVS=volumesetname] [ ;HOMEVS=volumesetname] Parameters groupname The name of the new group, which must consist of one to eight alphanumeric characters, beginning with an alphabetic character.
Command Definitions L-O NEWGROUP connect The limit on the total cumulative session connect-time, in minutes, that the group is allowed. This limit is checked at logon and whenever the session initiates a new process. The maximum value you may specify with this command is 2,147,483,647 minutes. Default is the account connect limit. A group's connect limit cannot be specified as greater than the corresponding limit currently designed for the account in which the group resides.
Command Definitions L-O NEWGROUP ONVS Specifies a particular volume set on which the group is to be built. The volume set must be already defined and recognized by the system. The NEWGROUP command must be specified twice before files can be created in this group on a mountable volume set. The first NEWGROUP builds the group on the system volume set (from which the account is accessed). The second NEWGROUP then builds the account on the mountable volume set.
Command Definitions L-O NEWGROUP NEWGROUP GROUP1 To create a new group named G2 in the account GRIMSBY (on the system volume set) and give it process handling (PH) and multiple RINs (MR) capabilities, enter: NEWGROUP G2.
Command Definitions L-O NEWJOBQ NEWJOBQ The NEWJOBQ command creates a new job queue. Syntax NEWJOBQ qname [;limit=n] Parameters qname Name of the queue to be created. If a queue of this name already exists, an error is indicated. limit Maximum number of jobs that can be allowed in this queue. The limit value can be changed using the :limit [+-]n;jobq= command. If omitted, a value of zero is assumed. Operation Notes Limit is the only queue controlling property.
Command Definitions L-O NEWLINK NEWLINK Creates a link to a file, group, account, or directory. (Native Mode) Syntax NEWLINK[ LINK=] linkname [ ;TO=] sourceobject [ { ;SYMBOLIC} ] Parameters linkname The pathname that points to the file, that when created, will contain the link. linkname must resolve to a unique name. It may not be the name of an existing symbolic link, even if that link resolves to the name of a file or directory object that does not exist. This is a required parameter.
Command Definitions L-O NEWLINK Table 5-7 CI Commands Affected by Symbolic Links Command Name Follow Link Notes CHGROUP No None DISKUSE Yes/No Link is resolved before the operation is performed. If a symbolic link exists under the account that link is not resolved. Therefore disk space usage of its target is not included in the calculations. LISTACCT No None LISTFILE No Link is not resolved. Therefore, operation is performed on t he name specified.
Command Definitions L-O NEWLINK Examples The following tree structure will be used to construct the examples that follow it. Assume that the CWD is /ACCT1/PUB. ROOT || | | ACCT1 dir SOFTWARE | / \ | f1 f2 | | | | PUB dir1 PUB CODE | / \ | | file1 file2 ACCTORG | | | | | | ACCTUDC FILE3 COMMON TERMIO COMPALL / | \ f1 f2 dir3 dir2 To create a symbolic link named PAYCODE to the file PAYROLL.CODE.SOFTWARE, enter the following command: :NEWLINK LINK=PAYCODE; TO=PAYROLL.CODE.
Command Definitions L-O NEWLINK The following command creates FILE3 as a symbolic link to the nonexistent file SOURCE1.CODE.SOFTWARE. :NEWLINK LINK=FILE3.PUB.ACCT1; TO=SOURCE1.CODE.SOFTWARE The following command creates a symbolic link FILE4 as a link to an existing file. :NEWLINK LINK=FILE4.PUB.
Command Definitions L-O NEWUSER NEWUSER Creates a new user. Syntax NEWUSER username[ .acctname] [ ;PASS=[ password] ] [ ;CAP=[ capabilitylist] ] [ ;MAXPRI=[ subque uename] ] [ ;LOCATTR=[ localattribute] ] [ ;HOME=[ homegroupname] ] [ ;UID=[ uid] ] [ ;USERPASS=[ { REQ OPT } ] [ Expired] ] The USERPASS parameter is only available if the HP Security Monitor has been installed. Parameters username The name of the user.
Command Definitions L-O NEWUSER subqueuename The name of the highest-priority subqueue that any job or session in the account can request for executing processes. The subqueuename may be either AS, BS, CS, DS, or ES. The priority specified for the user in NEWUSER cannot be greater than that specified for the account. The subqueuename defined for the user is checked against the subqueuename defined for the user's account at logon.
Command Definitions L-O NEWUSER Table 5-8 User Capabilities Capability Mnenonic System Manager SM Account Manager AM Account Librarian AL Group Librarian GL Diagnostician DI System Supervisor OP Network Administrator NA Node Manager NM Save Files SF Access to Nonshareable I/O Devices ND Use Volumes UV Create Volumes CV Use Communication Subsystem CS Programmatic Sessions PS User Logging LG Process Handling PH Extra Data Segments DS Multiple RINs MR Privileged Mode PM
Command Definitions L-O NEWUSER To define a new user named LHSMITH, assign a password of SMITTY, a home group of HOMEGPX, and assign a UID of 120, enter: NEWUSER LHSMITH;UID=120;PASS=SMITTY;HOME=HOMEGPX Related Information Commands ALTUSER, LISTUSER, NEWACCT, NEWGROUP, PURGEUSER Manuals Performing System Management Tasks (32650-90004) 396 Chapter 5
Command Definitions L-O NSCONTROL NSCONTROL Controls the Network Service subsystem. Syntax NSCONTROL function[ ;function] ... function may be START=[ service[ ,service] ...] STOP= [ service[ ,service] ...] ABORT AUTOLOGON= [ { ON OFF } ] [ { ,ALL [ ,service[ ,service] ] } ] LOADKEYS LOG= [ { ON OFF } ] [ ,ALL ,RPM ,ENV ,DSDAD ,DSSERVER ,VTSERVER ] [ { ,LOW ,HIGH } ] SERVER= { servername ALL } [ ,minservers] [ ,maxservers] STA TUS= [ USERS SERVICES SERVERS SUMMARY ALL [ ,...
Command Definitions L-O NSCONTROL RFAL Enables local users to access files and data bases on remote nodes. RPM Enables remote users to create and kill processes on the local node using the Remote Process Management (RPM) service. RPML Enables local users to create and kill processes on the local and remote nodes using the Remote Process Management (RPM) service. VT Enables remote users to logon to the local node using HP's TCP message mode.
Command Definitions L-O NSCONTROL ENV LOW Logs environment information from DSLINE and REMOTE HELLO commands. ENV HIGH Same as LOW, plus environment table locking and use counts. DSDAD LOW Logs creation and deletion of sockets, ports, and server processes. DSDAD HIGH Same as LOW, plus all received service requests and internal messages between DSDAD and server processes. DSSERVER LOW Logs internal initialization messages between DSDAD and DSSERVER processes.
Command Definitions L-O NSCONTROL NOTE STATUS The total number of all active servers may not exceed 1250. The sum of all minservers must always be 1250 or less. You may specify a number greater than 1250 as one or more maxservers values, but there will never be more than a total of 1250 servers of all kinds at any one time. Displays current status information about NS3000/XL Services. STATUS[=USERS|SERVICES|SERVERS|SUMMARY|ALL[,...
Command Definitions L-O NSCONTROL NSCONTROL SERVER Alters the characteristics of the Network Service processes. NSCONTROL STATUS Displays information about the Network Services. NSCONTROL VERSION Displays the overall version of the Network Services subsystem, and optionally the version of each of its modules.
Command Definitions L-O OCTCOMP OCTCOMP Converts a compiled MPE V/E program into native mode (NM) code for the HP 3000 Series 900. (Native Mode) CAUTION Before using this command be sure your logon group and account does not contain files of the form Yn, Ynn or Ynnn where n is any alphanumeric character. OCTCO MP may create temporary files named in this format and similarly named permane nt files may cause an error condition.
Command Definitions L-O OCTCOMP add=seglist [;] Add translated segments to the file named in the command string. Note that the named file may already contain translated code. When you specify this option, OCTCOMP replaces already translated segments. If you use the add option, the targetfile, ignore, and trans parameters are not permitted. This option works only for SL files. errors [=count][;] Specify maximum number of errors to be reported before OCTCOMP terminates.
Command Definitions L-O OCTCOMP or 0 .. 7 - Octal or $0 .. F - Hexadecimal or A[..] .. Z[..] - Alpha (SL only) * or ^filename (an indirect file) ** * In this form, a segnum identifier may consist of as many as 16 characters, beginning with an alphabetic character. ** You must number indirect files, and you cannot nest them. If you enter the trans parameter, you may not use the add or ignore parameters. Operation Notes The OCTCOMP command translates MPE V/E instructions into native mode instructions.
Command Definitions L-O OCTCOMP Examples The following set of examples illustrates the use of the add=, ignore=, and trans= parameters and the effect each of them has on the content of the translated code output file with each succeeding invocation of OCTCOMP. In each example, the input file is assumed to consist of seven segments, 0 through 6. In the following example, the translated output file, OCTOUT, consists of the SL file SOURCEIN and translated segments 1, 2, 3, and 4 only.
Command Definitions L-O OPENQ OPENQ Opens the spool queue(s) for a specified logical device, or device name or all device members of a device class. (Native Mode) Syntax OPENQ{ ldev[ ;SHOW] devclass[ ;SHOW] devname[ ;SHOW] @ } Parameters ldev The logical device number of the device. devclass The device class name of the devices. The devclass parameter must begin with a letter and consist of eight or fewer alphanumeric characters. devname The device name of the device.
Command Definitions L-O OPENQ Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. It may be executed only from the console unless distributed to users with the ALLOW or ASSOCIATE command.
Command Definitions L-O OPTION OPTION Modifies the runtime environment of user-defined commands and command files. It is used within the body of a user command to set up and change the environment dynamically. (Native Mode) NOTE Be sure to distinguish between the OPTION command and OPTION used in the header of a user command. The OPTION command (described here) accepts only the LIST/NOLIST and RECURSION/NORECURSION parameters.
Command Definitions L-O OPTION The LIST/NOLIST option specifies whether command lines in a UDC are printed before execution of each command. RECURSION/ NORECURSION determines the search order for commands cataloged. RECURSION starts the UDC search at the beginning of the cataloged commands. NORECURSION, the default setting, starts the search at the command currently executing. RECURSION and NORECURSION do not have any meaning in a command file, because command files are not cataloged.
Command Definitions L-O OUTFENCE OUTFENCE Defines the minimum priority that an output spoolfile needs in order to be printed. (Native Mode) Syntax OUTFENCE outputpriority[ ;LDEV=ldev] [ ;DEV= { ldev devclass devname } ] Parameter outputpriority A number between 1 and 14, inclusive. A larger number is more limiting. ldev The logical device number of an output device. devclass A device class containing at least one output spoolable device.
Command Definitions L-O OUTFENCE Examples To defer all output spoolfiles except those waiting to be printed by LDEV 6, which is usually configured as the system line printer, set the global outfence to 14 and the outfence of LDEV 6 to 7, as shown below: OUTFENCE 14 OUTFENCE 7;LDEV=6 To display the new global outputpriority and the outputpriority of logical device 6, execute the LISTSPF or SHOWOUT command, as in the example below.
Command Definitions L-O OUTFENCE 412 Chapter 5
Command Definitions P-R 6 Command Definitions P-R Chapter 6 413
Command Definitions P-R PASCAL 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. Syntax PASCAL[ textfile] [ ,[ uslfile] [ ,listfile] ] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definitions P-R PASCAL Operation Notes 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.
Command Definitions P-R PASCALGO 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. Syntax PASCALGO[ textfile] [ ,listfile] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definitions P-R PASCALGO 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. Use This command may be issued from a session, job, or program. It may not be used in BREAK.
Command Definitions P-R PASCALPREP 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. Syntax PASCALPREP[ textfile] [ ,progfile] [ ,listfile] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file.
Command Definitions P-R PASCALPREP 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. Operation Notes 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.
Command Definitions P-R PASSWORD PASSWORD Creates or changes a user password. (Native Mode) Syntax PASSWORD Parameters None. Use 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. Operation 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.
Command Definitions P-R PASXL 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) Syntax PASXL[ textfile] [ ,[ objectfile] [ ,[ listfile] [ ,libfile] ] ] [ ;INFO=quotedstring] Parameters 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.
Command Definitions P-R PASXL 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).
Command Definitions P-R PASXL 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.
Command Definitions P-R PASXLGO 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) Syntax PASXLGO[ textfile] [ ,[ listfile] [ ,[ libfile] ] ] [ ;INFO=quotedstring] Parameters 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.
Command Definitions P-R PASXLGO 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. Operation Notes The PASXLGO command compiles, links, and executes an HP Pascal/iX program. If textfile is omitted, the compiler expects input from your standard input device.
Command Definitions P-R PASXLLK 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) Syntax PASXLLK[ textfile] [ ,[ progfile] [ ,[ listfile] [ ,libfile] ] ] [ ;INFO=quotedstring] Parameters 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.
Command Definitions P-R PASXLLK 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. Operation Notes The PASXLLK command compiles and links an HP Pascal/iX program into a file on disk. If you do not specify textfile, the compiler expects input from the standard input device.
Command Definitions P-R PAUSE 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.
Command Definitions P-R PAUSE 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".
Command Definitions P-R PAUSE Examples 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.
Command Definitions P-R PAUSE The 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. :PAUSE , @mgr@.
Command Definitions P-R PLISTF (UDC) 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 Syntax PLISTF[ fileset] [ ,format_opt] [ ;outfile] Parameters The following parameters are supported with the PLISTF UDC.
Command Definitions P-R PLISTF (UDC) Related Information Commands LISTF, LISTFILE, LISTDIR (UDC), FINDFILE (UDC), FINDDIR (UDC) Manuals None Chapter 6 433
Command Definitions P-R PREP PREP Prepares a compatibility mode program from a user subprogram library (USL) file onto a program file. Syntax PREP uslfile,progfile [;ZERODB][;CAP=capabilitylist] [;PMAP] [;RL=filename] [;MAXDATA=segsize] [;PATCH=patchsize] [;STACK=stacksize] [;DL=dlsize] [;NOSYM] [{;FPMAP | ;NOFPMAP}] Parameters uslfile Actual file designator of user subprogram library (USL) file into which the program has been compiled.
Command Definitions P-R PREP 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.
Command Definitions P-R PREP A compiled program is prepared by searching a relocatable library (RL) to satisfy references to external procedures required by the program. When the program is prepared, such procedures are linked to the program in the resulting program file. To use a relocatable library (RL), you must have READ and LOCK access to it. NOTE The MPE segmenter employs temporary files named T999SYM, SEGTMP01, and SEGTMP00.
Command Definitions P-R PREPRUN PREPRUN Prepares and executes a compiled compatibility mode program.
Command Definitions P-R PREPRUN 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.
Command Definitions P-R PREPRUN 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.
Command Definitions P-R PREPRUN STDLIST This parameter allows the user to specify the file to be used as $STDLIST by the program being executed. If $STDLIST is omitted, or if nothing is specified after the equal sign, such as $STDLIST=, then $STDLIST defaults to the job or session's standard list device. This parameter has the same subparameters as $STDIN, but you may also specify the keyword NEW. NEW The name to be assigned to a job/session temporary disk file created with the system defaults.
Command Definitions P-R PREPRUN To prepare and execute a program from the USL file UBASE that begins execution at the entry point RESTART, that has a stacksize of 800 words, and searches an RL file named LIBA, enter: PREPRUN UBASE,RESTART;STACK=800;RL=LIBA The following example prepares and runs a program with $STDIN set to the existing disk file INPUT.
Command Definitions P-R PRINT PRINT Prints the contents of a file. Syntax PRINT filename [OUT=outfile] [START=m] [END=n] [PAGE=p] [;UNN | NUM] [;NONUM] Parameters filename Actual file name of the file to be printed to $STDLIST, unless outfile is specified as a destination. To specify an HFS file, begin the filename with a dot (.) or slash (/). The filename may specify either a temporary or a permanent disk file.
Command Definitions P-R PRINT n NOTE p Specifies the last record of the file to be displayed. An n is relative to 1. If n is a negative number, it specifies a location relative to the end-of-file, that is, -5 indicates the fifth record from the end-of-file. Zero is an invalid specification. Default is the last record of the file. For byte stream files, you cannot display one or more records by specifying a negative number with the keywords START= or END=.
Command Definitions P-R PRINT NUM Specifies numbering of the lines as they are displayed. The numbers appear in front of the line (record) being displayed. The number displayed is the actual line number for numbered files; for unnumbered files, relative numbering begins with 1. NONUM Requests that trailing digits at the end of each record in the file be displayed as part of the file content, rather than being interpreted as line numbers.
Command Definitions P-R PRINT TAIL MYFILE To print the last 45 records of MYFILE, because entering the value 45 overrides the default value of 10, enter: TAIL MYFILE, 45 The PRINT command itself can be used to create a file: NOTE PRINT $STDIN,TAILB PARM FILE, LAST=5 PRINT !FILE; START = -!LAST :EOD SAVE TAILB The SAVE command is used to make the file TAILB permanent since the default is temporary.
Command Definitions P-R PRINT The above file was considered by PRINT to be a numbered file and thus the trailing 8 bytes are truncated NOTE PRINT UFILEYES;NONUM aaaaaaaaaaaa00010001 bbbbbbbbbbbb00010002 cccccccccccc00010003 dddddddddddd00010004 eeeeeeeeeeee00020001 ffffffffffff00020002 gggggggggggg00020003 hhhhhhhhhhhh00020004 iiiiiiiiiiii00030001 jjjjjjjjjjjj00030002 kkkkkkkkkkkk00030003 llllllllllll00030004 HFS Example The following command entry will print the last 10 records of the file called posix
Command Definitions P-R PURGE PURGE This command deletes one or more files from the system. Syntax PURGE filereference [ ;TEMP] [ [ ;ONERROR=] { CONTINUE QUIT [ { ;AUTOLOCKWORD ;NOAUTOLOCKWORD } [ { ;CONFIRM ;NOCONFIRM ;CONFIRMALL } [ { ;NOSHOW ;SHOW } ] [ { ;SHOWERRORS } ] ] ] ;NOSHOWERRORS } ] Parameters filereference The actual file designator of the file to be deleted, interpreted according to MPE-escaped semantics filereference, can be either an MPE file (i.e.
Command Definitions P-R PURGE • "N", "NO", or Return to retain the file • "Q", "QUIT", or Break to stop the PURGE command The CONFIRMALL option is ignored in jobs and when you are purging a single file. NOSHOW Suppresses the display of each successfully purged file. NOSHOW is the default. SHOW Displays the name of each successfully purged file. SHOWERRORS Displays each lower-level error which prevents a file from being deleted. The name of the file is shown, followed by the error message.
Command Definitions P-R PURGE :PURGE /users/jeff/bin/FILES/file@ 3 FILES matched Continue PURGE? (YES/NO) yes 3 selected. 3 succeeded. 0 failed. • To purge multiple files interactively using wildcards To purge a number of files, one at a time, in an interactive mode so that you can skip a file or stop your purge, you can use the CONFIRMALL option.
Command Definitions P-R PURGEACCT PURGEACCT Removes an account and its groups and users from the system directory or from the specified volume set's directory. Syntax PURGEACCT acctname[ ;ONVS=volumesetname] Parameters acctname Name of the account to be deleted. This name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. volume- setname The volume set from which the account is to be purged.
Command Definitions P-R PURGEACCT CAUTION Do not attempt to purge the SYS account. The SYS account cannot be completely purged, but you can destroy critical files by attempting to do so. If you execute PURGEACCT SYS, all groups except PUB are purged; all users except the system manager are purged; and all inactive files and system files in the PUB group are purged.
Command Definitions P-R PURGEDIR PURGEDIR Purges (unlinks) one or more directories. Syntax PURGEDIR[ dir=] dir_name [ { ;TREE ;NOTREE ;USENAME } ] [ { ;CONFIRM ;NOCONFIRM ;CONFIRMALL } ] [ { ;NOSHOW ;SHOW } ] [ { ;SHOWERROR ;NOSHOWERROR } ] Parameters dir_name The name of the directory that is being purged (required). The dir_name is assumed to be an MPE name unless you begin it with a dot (.) or a slash (/) to indicate an HFS directory.
Command Definitions P-R PURGEDIR • "N", "NO", or Return to retain the directory • "Q", "QUIT", or Break to stop the PURGE command The CONFIRMALL option is ignored in jobs and when you are purging a single directory. SHOW Displays to $STDLIST each file or directory under dir_name that was purged. Directory names are always displayed in an HFS syntax, even if the name was specified as an MPE name. NOSHOW Suppresses the display of each file and directory purged. NOSHOW is the default.
Command Definitions P-R PURGEDIR 2. If dir_name is an HFS name, ends in a slash (/), and the ;NOTREE option is not requested, then a TREE purge occurs. The dir_name parameter cannot reference root (/) because purging root is undesirable, and most likely is not what is intended. A file or directory is not deleted if it is being accessed (opened); however, all non-accessed objects under dir_name are still purged.
Command Definitions P-R PURGEDIR The next example shows the command to purge MYDIR. PURGEDIR mydir The next example shows the command to purge MYDIR and all objects below. PURGEDIR mydir;TREE The next example illustrates the SHOW and TREE options. PURGEDIR dir;SHOW;TREE ./DIR/A ./DIR/B ./DIR/dir1/A ./DIR/dir1/B ./DIR/dir1 ./DIR/C ./DIR PURGEDIR /dir1/dir2;SHOW;TREE /dir1/dir2/file1 /dir1/dir2/file2 /dir1/dir2 PURGEDIR ./foo/;show ./foo/dir1_below_foo/f1 ./foo/dir1_below_foo/f2 ./foo/dir1_below_foo .
Command Definitions P-R PURGEDIR To delete all directories under the CWD with names beginning with TMP all objects below these directories: :purgedir TMP@; TREE To delete all directories under the CWD with names ending with TMP all objects below these directories: :purgedir ./@TMP/ When wildcards are specified with dir_name, then RD access is required to the parent directory of each wildcard component.
Command Definitions P-R PURGEGROUP PURGEGROUP Removes a group (and all files belonging to it) from the system or from the specified volume set directory. Syntax PURGEGROUP groupname[ .acctname] [ ;ONVS=volumesetname] Parameters groupname Name of the group in the logon account to be removed. This name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. acctname Specifies the account in which the group is found.
Command Definitions P-R PURGEGROUP If you specify volume-related commands or parameters for a volume set that is not currently mounted, or for an account that does not exist, MPE/iX returns an error message. CAUTION Do not attempt to purge the PUB group of the SYS account. The public group of the system account, PUB.SYS, cannot be completely purged.
Command Definitions P-R PURGEJOBQ PURGEJOBQ Removes a job queue Syntax PURGEJOBQ qname Parameters qname is the name of the queue to be deleted Operation Notes The PURGEJOBQ command deletes a job queue. The queue will be deleted only if it is empty, that is, if no jobs are waiting or executing in the queue. The default system job queue can not be purged. The user must have SM or OP capability to execute the command. This command is available in a session, job. or in BREAK.
Command Definitions P-R PURGELINK PURGELINK Removes a link. (Native Mode) Syntax PURGELINK[ LINK=] linkname Parameters linkname The name of a symbolic link file. All rules regarding file name specification apply to this parameter. This is a required parameter. You may not use wildcards in linkname or specify a file equation in place of linkname. Operation Notes A symbolic link is a special file that can point to a file, group, account, or directory.
Command Definitions P-R PURGEUSER PURGEUSER Removes a user from an account. Syntax PURGEUSER user[ .acctname] Parameters user Name of the user to be deleted. acctname Specifies the name of the account in which the user is found. Default is the logon account of the account manager. Operation Notes Account managers use the PURGEUSER command to delete a user from an account. You are asked to verify the command only when it is executed during a session, and not from a job.
Command Definitions P-R PURGEUSER Related Information Commands PURGEACCT, PURGEGROUP, NEWUSER, ALTUSER Manuals Performing System Management Tasks 462 Chapter 6
Command Definitions P-R RECALL/=RECALL RECALL/=RECALL Displays all pending console REPLY messages. Syntax RECALL=RECALL Parameters None. Operation Notes A user, the system operator, a job or a program issues the RECALL command to determine if any pending resource requests are currently awaiting a response. Pending resource requests are responded to by using the REPLY command. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions P-R RECALL/=RECALL Performing System Operation Tasks 464 Chapter 6
Command Definitions P-R REDO REDO Allows the user to edit and reexecute any command still retained in the command line history stack. (Native Mode) Syntax REDO[ [ CMD=] cmdid] [ [ ;EDIT=] editstring] 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. Parameters cmdid Specifies the command to execute.
Command Definitions P-R REDO The edit string must be surrounded by quotation marks (" ") if it contains any scanner/parser delimiters such as: , ; " ' [ ] or = or spaces. Operation Notes REDO executes the command specified as cmdid. The user may specify an optional editstring that edits the command before it is reexecuted. This command is a companion to the MPE/iX DO command. Unlike the DO command, the REDO command does permit interactive editing.
Command Definitions P-R REDO Directive Effect ^w UPSHIFT WORD. Upshifts the word starting at the position specified by ^. A word is defined as all characters except a space, comma, or semicolon. If you place the ^ directly beneath a word delimiter, the delimiter is skipped and only the word is upshifted. If no word exists on the command line, no upshift occurs. You may follow this directive with other edits. ^delim UPSHIFT TO DELIMITER.
Command Definitions P-R REDO Directive Effect >^ UPSHIFT FROM EOL. Upshifts the character at the current EOL. You may specify multiple ^'s to upshift a series of characters (read right-to-left) from the EOL. Also, you may follow this directive with other edits. >^w UPSHIFT WORD FROM EOL. Upshifts the last word in the command line. You may follow this directive with other edits. >^delim UPSHIFT TO DELIMITER FROM EOL.
Command Definitions P-R REDO Table 6-4 REDO Editing Samples Edit Action u First occurrence undoes the previous edits. The u must be in column one. u Second occurrence undoes all edits on the current line. The u must be in column one. rxyz Replaces the current text with xyz starting at the position of r. xyz Replaces the current text with xyz starting at the position of x. ixyz Inserts xyz into the current line, starting at the position immediately before the i.
Command Definitions P-R REDO Use This command is available in a session or in BREAK. It is not available in a job or from a program. Pressing Break aborts the execution of this command. Examples The following are examples of editing options for the REDO command: REDO PAS Edits the most recent command beginning with the string PAS. REDO 10 Edits command number 10 (absolute) on the command history stack. REDO -2 Edits the second-to-last command on the stack (one command before the most recent).
Command Definitions P-R REFUSE REFUSE Disables jobs/sessions and/or data on a designated device. Syntax REFUSE[ JOBS,] [ DATA,] ldev Parameters JOBS Disables the JOB (or HELLO) command from the designated device. DATA Disables the DATA command from the designated device. ldev The logical device number of the device for which JOB (or HELLO) and DATA commands are refused.
Command Definitions P-R RELEASE RELEASE Removes security provisions from a file. Security does not resume for a released file until you enter the SECURE command for the file. Syntax RELEASE filereference Parameters filereference Specifies the actual file designator of the file whose file access matrix access control you want to disable. The filereference can be either in MPE or HFS syntax.
Command Definitions P-R RELEASE Privileged files You cannot release privileged files. Lockwords You cannot override lockwords. ACDs This command does not affect the security on files with access control definitions. However, if you remove the ACD, the file is released. Refer to the ALTSEC command in this book for more information about ACDs. Use You can enter this command from a session, a job, a program, or in BREAK. Pressing Break does not affect this command.
Command Definitions P-R RELLOG RELLOG Removes a user logging identifier from the system. Syntax RELLOG logid Parameters logid The logging identifier to be removed from the system. Operation Notes The RELLOG command removes a user logging identifier from the system by deleting it from the directory of logging identifiers. This command may be issued only by the user who created the logging identifier. System supervisor (OP) or user logging (LG) capability is required to use this command.
Command Definitions P-R RENAME RENAME Changes the file name, lockword, and/or group name of a disk file. Syntax RENAME oldfilereference,newfilereference[ ;TEMP] Parameters oldfilereference Current name of file, written in the format: [*]filename[/lockword][.groupname[.acctname]] To use HFS syntax, preceed the file name with a dot (.), or a slash (/). newfilereference New name of file, in the same format as oldfilereference.
Command Definitions P-R RENAME Files in HFS directories can be renamed to files in the MPE account group structure, and they can be renamed to files in other HFS directories. You cannot rename a directory. If either oldfilereference or newfilereference is actually a directory, you will get an error. Spool Files If you have access to spoolfiles, you can rename them. In this case, the name of the file changes, but the contents and links to the spooler remain the same.
Command Definitions P-R REPLY/=REPLY REPLY/=REPLY Replies to pending resource requests at the console. Syntax REPLY pin,reply =REPLY pin,reply Parameters pin The process identification number (PIN) of the message sender. As part of the message requesting the REPLY, the PIN always appears after the second slash mark (/). In the following example, the PIN is 43.
Command Definitions P-R REPLY/=REPLY Examples Use the REPLY command to respond to a message from the MPE/iX system, as follows: 10:05/#J19/15/LDEV# FOR "NAS" OF TAPE1600 (NUM)? REPLY 15,7 or CTRL A =REPLY 15,7 Use the REPLY command to respond to a FORMS message from the MPE/iX system, as follows: 15:46/#S93/22/FORMS: PLEASE MOUNT MAILING LABEL FORMS ?15:46/#S39/22/SP#12/LDEV# FOR #S93;OUTFILE ON LP (NUM)? REPLY 22,12 15:46/#S39/22/LDEV#12 FORMS ALIGNED OK (Y/N)? Answering NO causes the printing to be de
Command Definitions P-R REPORT REPORT Displays accounting information for the logon account and group. Any user may obtain REPORT information about the user's logon group. (Compatibility Mode) Syntax REPORT[ groupset] [ ,listfile] [ ;ONVS=[ volumesetname] ] Parameters groupset Specifies the accounts and groups for which information is to be listed.
Command Definitions P-R REPORT Specifies one alphanumeric character (A?# = all the three-character names that begin with A, followed by an alphanumeric, followed by a digit.) ? The characters may be used as follows: n@ Report on all groups starting with the character "n". @n Report on all groups ending with the character "n". n@x Report on all groups starting with the character "n" and ending with the character "x". n##``...# Report on all groups starting with the character "n".
Command Definitions P-R REPORT If you specify the ONVS= parameter, REPORT displays file space counts for the specified volume set(s) only. If you specify a non-system volume, all other volume names are also displayed, but their file space counts are displayed as zero even though they may not be zero. You should always specify ONVS= when @.@ is the groupset parameter.
Command Definitions P-R RESET RESET Cancels file equations. Syntax RESET{ formaldesignator @ } Parameters formaldesignator A formal file designator name in the form file[.group[.account]] [:nodespec], for which a FILE command has been issued. The nodespec portion may be an environment identifier indicating the location of the file, or it may be $BACK. Specifying $BACK means that the file resides one "hop" back toward your local system (which may be the local system itself).
Command Definitions P-R RESET Manuals Chapter 6 None 483
Command Definitions P-R RESETACCT RESETACCT Resets the running counts of CPU-time or connect-time accumulated by an account and by all groups within that account to zero. Syntax RESETACCT[ { @ acct } [ ,{ CPU CONNECT } ] ] Parameters @ Specifies that the counters for all accounts, and all groups within the accounts, are to be reset. Default. acct Specifies the name of a particular account, and all groups within the account are to be reset.
Command Definitions P-R RESETDUMP RESETDUMP Disarms the debug facility call that is made during abnormal process termination. (Native Mode) Syntax RESETDUMP Parameters None Operation Notes This command disarms the debug facility (armed by using the SETDUMP command) after a process abort. It affects all processes created later under the current session or job. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions P-R RESTORE RESTORE Returns files that have been stored on backup media to the system. Syntax RESTORE[ restorefile] [ ;filesetlist] [ ;option[ ;...] ] where option is: [ ;SHOW [ =showparmlist]] [ ;ONERROR= { QUIT | SKIP | FULL}] [;{ LOCAL GROUP=groupname ACC[OUN]T=accountname}] [;CREATE= { ACCT | GROUP | CREATOR | PATH }] [;CREATOR[ =username]] [;GID[ =filegroupname]] [;KEEP NOKEEP] [;OLDDATE NEWDATE] [;DIRECT0RY] [;LISTDIR] [;PROGRESS[ =minutes]] [ ;FCRANGE=filecode/filecode[,...
Command Definitions P-R RESTORE If restorefile is not supplied and the RESTORESET option is not used, then RESTORE creates a default file name. The default file name is the user's logon username. No file equation is used. Sequential and parallel devices are specified with the RESTORESET option. Similarly, magneto-optical devices are specified using the MOSET option. You should not specify restorefile when using RESTORESET or MOSET. A disk file can also be specified with a file equation for restorefile.
Command Definitions P-R RESTORE The system restores any file that matches filestorestore unless the file also matches filestoexclude, which specifies files to be excluded from the RESTORE operation. You may specify an unlimited number of filestoexclude. Since "-" is a valid character for HFS syntax file names, a blank character must separate it from HFS file sets to obtain the special negative file set meaning.
Command Definitions P-R RESTORE @n Restore all files ending with the character n. n##...# Restore all files starting with character n followed by up to seven digits (useful for storing all EDIT/3000 temporary files). n@x Restore all files starting with the character n and ending with the character x. ?n@ Restore all files whose second character is n. n? store all two-character files starting with the character n. ?n Restore all two-character files ending with the character n.
Command Definitions P-R RESTORE Database corruption may result if not all database files are restored from a backup. Be sure that you only want to restore certain database files before overriding the default behavior with ;PARTIALDB. MPE and HFS Naming Equivalences When an MPE name component is a single @ wildcard, the @ will be "folded" to include all MPE and HFS named files at that level and below. To specifiy only MPE-named files, use ?@ instead. MPE wildcards are not expanded in filestoexclude.
Command Definitions P-R RESTORE @.@ All (MPE and HFS) files in the logon account. @.@.@ All the files and directories (MPE and HFS) on the system. ?@.@.@ All MPE named files on the system. Request to list names of restored files. Default is a listing of the total number of all files restored and not restored. For files not restored, the reason and the names are listed.
Command Definitions P-R RESTORE SECURITY For MPE format listing, causes SHOW to display the creator and the file access matrix for all the files which do not have an active ACD. For files with active ACDs only, the phrase *ACD EXISTS* is displayed. For HFS format listing, the phrase *ACD EXISTS* or *ACD ABSENT* is displayed, depending on whether the file has an ACD. ONERROR PATH Forces all file listings to be in HFS format. Full HFS pathnames are displayed instead of MPE style names.
Command Definitions P-R RESTORE If no suboptions are specified, then CREATE defaults to ACCOUNT,GROUP,CREATOR,PATH for SM or OP, to GROUP,CREATOR,PATH for AM, and to PATH for everything else. If CREATE is specified, the necessary directory structures are created, provided the user has the appropriate capabilities. System Manager (SM) or System Supervisor (OP) capability is needed for account, group, and user creation. Account Manager (AM) capability is needed for group and user creation.
Command Definitions P-R RESTORE filegroupname The file sharing group name which will be the new gid for all files being restored. If this parameter is not specified then the gid on the media is preserved. KEEP If a file on the RESTORE media has the same name as a file already residing on the disk, KEEP instructs the system to preserve the file on the disk and to skip over the file on the RESTORE media. The file on tape is not restored and the file on the disk remains as it was.
Command Definitions P-R RESTORE FILES= maxfiles If you are restoring a large number of files from an MPE V/E (transport) tape, specify a number at least as large as the number of files to be restored. The default is 4000. This parameter is ignored when you are restoring MPE XL format store tapes. No limit is imposed. When a FILES= option is put in an indirect file, it is ignored. DEV= device Specifies the device on which the restored files are to reside.
Command Definitions P-R RESTORE volumesetname A volume set name. If you specify the VOL or VOLCLASS options, the corresponding volume/volume class name must reside within this volume set. Volume Set Notes VOLSET, VOLCLASS and VOL may not be used with the DEV option. You can inadvertently restore files to groups or accounts that you did not intend.
Command Definitions P-R RESTORE Database corruption may result if not all database files are restored from a backup. Be sure that you only want to restore certain database files before overriding the default behavior with ;PARTIALDB. THE FOLLOWING OPTIONS ARE AVAILABLE ONLY IF TURBOSTORE XL OR TURBOSTORE XL II IS INSTALLED ON YOUR SYSTEM. TURBOSTORE IS NOT PART OF THE FUNDAMENTAL OPERATING SYSTEM, BUT MAY BE PURCHASED SEPARATELY.
Command Definitions P-R RESTORE NAME This parameter must be specified with the MOSET option, and cannot be specified without it. If specifies the logical name to be used for the backup. For example: RESTORE @.@.@;;MOSET=(12);NAME=DAILY.D23OCT90.BOZO This name could indicate that the restore should be taken from the daily backup done on 23 Oct 1990 on the system called BOZO. backupname A three field name of a total maximum length of 26 characters. The format is fname.gname.aname.
Command Definitions P-R RESTORE The system manager and system supervisor may restore lockword-protected files without specifying the lockword only when RESTORE is executed during a session. Users without SM or OP capability must always supply the lockword. The exception is AM. If you have AM and you are working in your own account, you do not have to supply the lockword. If RESTORE is executed as a job, however, all users lacking SM, OP, or AM capability must supply file lockwords.
Command Definitions P-R RESTORE To restore a file ABC without specifying a restorefile, no file equation need be used. For example: :RESTORE ;ABC.PUB.SYS;SHOW TURBO-STORE/RESTORE VERSION A.50.11 HP36398A (C) 1986 HEWLETT-PACKARD CO. WED, NOV 23 1994 11:22 AM WILL RESTORE 1 FILES ; NUMBER OF FILES ON MEDIA FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS ABC .PUB .
Command Definitions P-R RESUME RESUME Resumes execution of a suspended operation. (Native Mode) Syntax RESUME Parameters None. Operation Notes After a program or MPE/iX command operation is suspended by pressing Break or by using the CAUSEBREAK intrinsic, the RESUME command resumes execution of the operation at the point where the execution was suspended. Note that the RESUME command is legitimate only during a BREAK.
Command Definitions P-R RESUME Manuals 502 None Chapter 6
Command Definitions P-R RESUMEJOB RESUMEJOB Resumes a suspended job. (Native Mode) Syntax RESUMEJOB #Jnnn Parameters #Jnnn A job number. Operation Notes The system operator uses the RESUMEJOB command to resume processing a job suspended with the BREAKJOB command. The job continues execution from the point at which it was suspended; no message is issued. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions P-R RESUMELOG RESUMELOG Resumes system logging following suspension caused by an error. (Native Mode) Syntax RESUMELOG Parameters None. Operation Notes When the operator resumes logging with the RESUMELOG command, a special log record is displayed that denotes the number of log events and corresponding records that were not recorded while logging was suspended, the total number of unrecorded job initiation records, and the total number of unrecorded job/session termination records.
Command Definitions P-R RESUMESPOOL RESUMESPOOL Resumes suspended spooler output to a spooled device. Syntax RESUMESPOOL ldev;BACK[ nnn FILES nnn PAGES ] RESUMESPOOL ldev;FORWARD[ nnn FILES nnn PAGES ] RESUMESPOOL ldev;BEGINNING Parameters ldev The logical device number of a spooled device. BACK Instructs the spooler to back up nnn files or nnn pages and resume printing at that point. (Refer to "Operation Notes.
Command Definitions P-R RESUMESPOOL By using the SPOOK utility with mode control ON, you can determine where each FOPEN intrinsic occurs within a spoolfile. This is useful, for example, when you are compiling, preparing, and running large programs, and printing the entire output is unnecessary. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions P-R RETURN RETURN Causes execution to return from the current user command (UDC or command file) to the calling environment. (Native Mode) Syntax RETURN Parameters None Operation Notes This command terminates the execution of the currently executing user command. Control resumes in the calling environment at the command line following the user command in which RETURN was embedded. Invoking RETURN at the CI colon (:) prompt has no effect.
Command Definitions P-R RPG RPG Compiles an RPG/V program in compatibility mode. RPG/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax RPG[ textfile] [ ,[ uslfile] [ ,[ listfile] [ ,[ masterfile] [ ,[ newfile] ] ] ] ] Parameters textfile The actual file designator of the input file from which the source program is read. This can be any ASCII input file. The formal file designator is RPGTEXT. Default is $STDIN.
Command Definitions P-R RPG NOTE The formal file designators used in this command (RPGTEXT, RPGUSL, RPGLIST, RPGMAST, and RPGNEW) 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. Operation Notes This command compiles an RPG program onto a user subprogram library (USL) file on disk.
Command Definitions P-R RPGGO RPGGO Compiles, prepares, and executes an RPG/V program in compatibility mode. RPG/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax RPGGO[ textfile] [ ,[ listfile] [ ,[ masterfile] [ ,newfile] ] ] Parameters textfile The actual file designator of the input file from which source program is read. This can be any ASCII input file. The formal file designator is RPGTEXT. Default is $STDIN.
Command Definitions P-R RPGGO Use This command may be issued from a session, job, or program. It may not be issued in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.
Command Definitions P-R RPGPREP RPGPREP Compiles and prepares an RPG/V program in compatibility mode. RPG/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax RPGPREP[ textfile] [ ,[ progfile] [ ,[ listfile] [ ,masterfile] [ ,[ newfile] ] ] ] Parameters textfile The actual file designator of the input file from which the source program is read. This can be any ASCII input file. The formal file designator is RPGTEXT.
Command Definitions P-R RPGPREP Operation Notes This command compiles and prepares an RPG program to a program file on disk. If you do not specify textfile, MPE/iX expects the source program to be entered from your standard input device. The USL file $OLDPASS, created during compilation, is a system-defined temporary file passed directly to the MPE segmenter. You can access it only if you do not use the $NEWPASS default for progfile.
Command Definitions P-R RPGPREP Related Information Commands RPG, RPGGO, PREP, RUN Manuals MPE Segmenter Reference Manual RPG/3000 Compiler Reference Manual 514 Chapter 6
Command Definitions P-R RPGXL RPGXL Compiles an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXL[ textfile] [ ,[ objectfile] [ ,[ listfile] ] ] [ ;INFO=quotedstring] 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.
Command Definitions P-R RPGXL Operation Notes The RPGXL command compiles an RPG/XL program and stores the object code in a file on disk. If textfile is not specified, RPG/XL expects the source program to be entered from your standard input ($STDIN). If you do not specify listfile, RPG/XL sends the listing to your standard list device ($STDLIST). If you omit the objectfile parameter, the object code is saved in the temporary file domain as $OLDPASS.
Command Definitions P-R RPGXL RPGXL MAIN, OBJMAIN FTNXL 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 RPGXL MAIN, RLFILE FTNXL SUB, RLFILE LINK RLFILE,SOMEPROG RUN SOMEPROG Related Information Commands RPGXLGO, RPGXLLK Manuals HP RPG/XL Programmer's Guide HP RPG/XL Reference Manual HP RPG Utilities Reference Manual Chapter 6 517
Command Definitions P-R RPGXLGO RPGXLGO Compiles, links, and executes an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXLGO[ textfile] [ ,[ listfile] ] 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.
Command Definitions P-R RPGXLGO Use 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.
Command Definitions P-R RPGXLLK RPGXLLK Compiles and links an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXLLK[ textfile] [ ,[ progfile] [ ,[ listfile] ] ] 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.
Command Definitions P-R RPGXLLK NOTE This command is implemented as a command file. If you set the HPPATH variable to null (SETVAR HPPATH ""), the command file is not executed, and the command fails. Use 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.
Command Definitions P-R RUN RUN Executes a prepared or linked program. (Native Mode) Syntax The only required parameter is progfile. If you specify any other parameters, they will override the default parameters that the creator of the program established, but only for that particular execution of the program. If run is implied, see operation note below.
Command Definitions P-R RUN The load map for a native mode program or library is a listing that describes the spaces loaded for a process and the linkages used to connect the external references of the process. When the lmap option is selected at run time, the listing is produced for the program and for each library specified by the user. The load map is organized into two major areas: the SOM's Description area, with one per loaded SOM, and the Process Data Dictionary area.
Command Definitions P-R RUN The sid (space ID) is the 32-bit virtual space number that was assigned for that space when it was loaded. The offset is the byte offset within the space relative to its beginning. The next grouping shows the condition of the shared global flag for this module. This information is only shown if the flag is set true. Locality Name Section Locality Name $LIT$ $UNWIND_START$ $DXRT$ $GLOBAL$ Type Address Length Code Code Data Data 2C5.5000 2C5.5348 240.41634000 240.
Command Definitions P-R RUN Stub This symbol marks an import (outbound). The Link Editor creates an import stub for the unsatisfied code symbols, and the Loader satisfies the reference by filling in the XRT entry allocated for this stub. Plabl This symbol defines an export stub for a procedure for which a procedure label has been generated. The Loader builds an XRT entry for the procedure at the offset allocated by the Link Editor.
Command Definitions P-R RUN A DXRT entry is indexed negatively from the DP of the SOM. The DXRT column gives this offset, which is in bytes. The value is in hexadecimal format. The DXRT Addr column gives the indirect address for the import symbol. The last column gives the access rights for the symbol.
Command Definitions P-R RUN Continuing with the PDD area, the remaining columns starting with Type through R/W are interpreted in the same manner as explained in the Export Data Section. Compatibility Mode A compatibility mode loader map shows information on the origin and destination of the reference. The exact origin or destination is identified by the file type, the segment within the file, and by the STT entry of the segment. The level of parameter checking is also listed.
Command Definitions P-R RUN DEBUG Instructs the process to enter the system debugger just before executing the first instruction of the program. Once the debugger has been invoked, the commands available to the user depend upon the user's assigned capability. The default is not to enter the system debugger. This parameter is ignored in a job. maxstack The maximum CM stack area (Z-DL) size permitted, in 16-bit words.
Command Definitions P-R RUN The default is -1, which currently instructs MPE/iX to assign a system-defined constant as the value of nmstacksize. nmheapsize The maximum size, in bytes, to which the NM heap may grow. This must be a decimal number. If a value is specified which is less than the system-defined minimum (including values <= 0), the system-defined value will be used. If a value is specified which is greater than the system-defined maximum value, the system-defined maximum value will be used.
Command Definitions P-R RUN In a list of libraries, each library must have a privilege level equal to or greater than the privilege level of the library that precedes it in the list. The privilege level of any file is governed by the privilege level of the group in which it resides. For example, RUN PROGA.grp.acct;XL='LIB1.PUB.TOOLS,LIB2.DIAG.SYS' Suppose the group grp does not have privileged mode (PM) capability. We assume for this example that the user is able to execute PROGA.grp.acct.
Command Definitions P-R RUN appear as cant'', " and " must appear as ""and"", 'but' must appear as but''''. The maximum length of the string, including delimiters, is 255 characters. Refer to "Examples." If the executing program is a compatibility mode program, Q(initial)-5 contains a byte pointer to the string, and Q(initial)-6 contains the number of characters in the string. The Q-relative addresses are 16-bit addresses. Q(initial) is the Q address for the outer block of the program.
Command Definitions P-R RUN $NULL The actual file designator of a system-defined file that is always treated as an empty file. When referenced by another program, a program receives only an end-of-file indication when accessed. When referenced by a program as $STDLIST, the associated write request is accepted by MPE/iX, but no physical output is actually performed. Thus, $NULL can be used to discard unneeded output from an executing program.
Command Definitions P-R RUN NOTE NM and CM loader error messages are reported differently, allowing you to determine the system in which the error occurred. NM Loader Error: ErrMessage (``LDRERR nnnn)'' CM Loader Error: ErrMessage (``LOAD ERR nnnn)'' The RUN command is parsed by the Compatibility Mode parser unless it is implied, in which case the Native Mode parser is used.
Command Definitions P-R RUN The next example runs a program using the STDIN parameter, setting $STDIN to an existing disk file named INPUT, this time referenced through a file equation.
Command Definitions S-SO 7 Command Definitions S-SO Chapter 7 535
Command Definitions S-SO SAVE SAVE Saves a file in the permanent system file domain. Syntax SAVE{ $OLDPASS,newfilereference tempfilereference } Parameters $OLDPASS A system-defined temporary file. After this file is saved, it can no longer be referenced by the name $OLDPASS. newfile-reference New actual file designator assigned to $OLDPASS when it is made permanent. Its format is: filename[/lockword][.groupname[.
Command Definitions S-SO SAVE This command applies only to temporary files on disk. It is similar to opening a file with the FOPEN intrinsic, and then closing it with the FCLOSE intrinsic, using a permanent file disposition. Use the SAVE command to save KSAM XL files. Since the KSAMUTIL utility is not supported for KSAM XL, the SAVE command is the only method of doing so. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions S-SO SECURE SECURE Reinstates all file security provisions that you previously suspended with the RELEASE command. Syntax SECURE filereference Parameters filereference Specifies the actual file designator for which you want to reinstate file access control. The filereference can be either in MPE or HFS syntax. MPE Syntax If the filereference does not begin with a dot or a slash, it is parsed according to the MPE syntax and has the form: filename[/lockword][.groupname[.
Command Definitions S-SO SECURE Example • To reinstate file access control previously in effect for the file named FILE1, enter: :SECURE FILE1 Related Information Commands ALTSECT, LISTF, LISTFILE, RELEASE' Manuals None Chapter 7 539
Command Definitions S-SO SEGMENTER SEGMENTER Starts the MPE segmenter. Syntax SEGMENTER [ listfile] Parameters listfile Actual file designator of an ASCII output file that is to receive listed output from the MPE segmenter. Formal file designator is SEGLIST. Default is $STDLIST. Usually this file is a line printer. This must be defined in a FILE command, and then backreferenced (see "Example").
Command Definitions S-SO SEGMENTER Related Information Commands FILE Manuals MPE Segmenter Reference Manual Chapter 7 541
Command Definitions S-SO SET SET Defines elements of the command interpreter. It also allows a job using a spooled $STDLIST to mark its standard list device for deletion when the job terminates. (Native Mode) Syntax SET[ STDLIST={ DELETE | SAVE } ] [;MSG={ON | OFF}] [ECHO={ ON| OFF}][ ;SPEED={ 300 | 1200 | 2400 | 4800 | 9600 | 19200 | 19.2K}] Parameters DELETE Flags the job's $STDLIST for deletion at job termination. SAVE Cancels the effect of a previous SET STDLIST=DELETE command. Default is SAVE.
Command Definitions S-SO SET Example The following example illustrates using the SET command from within a program: !JOB EXAMPLE, USER.TECHPUB,XGROUP !CONTINUE !RUN UPDATE.PUB.
Command Definitions S-SO SETCATALOG SETCATALOG Catalogs, or enables, the user-defined commands (UDCs) in a specified catalog file at the user, account, or system level. You can also use this command to disable all UDCs on the system. (Native Mode) WARNING If you do not specify a catfilename, all UDC's are disabled (deleted from the UDC directory) regardless of whether or not the ;DELETE option is used. Use only MPE/iX flat files as UDC files.
Command Definitions S-SO SETCATALOG DELETE Deletes the file(s) from the existing UDC directory. This permits the user to delete individual files from the catalog directory. The original order of the catalog is maintained. It also finds and makes adjustments for logon UDCs. The ACCOUNT and SYSTEM options allow the user to delete the cataloged file at the account or system levels. The default is user level. Operation Notes The SETCATALOG command allows you to catalog user-defined commands.
Command Definitions S-SO SETCATALOG SETCATALOG UDCA, UDCB SETCATALOG UDCA SETCATALOG UDCB ;APPEND In the first example, the command has an implied RESET, and thus overwrites the previous file set in the directory. In the second example, UDCA is entered into the directory, and then UDCB is appended to the directory without affecting UDCA. It also finds new logon commands if appropriate.
Command Definitions S-SO SETCLOCK SETCLOCK Alters the system time or system time zone. SYNTAX SETCLOCK{DATE=date spec; TIME=time spec [ ;GRADUAL | ;NOW]} {CORRECTION= correction spec} {TIMEZONE= time zone spec} { ;CANCEL} Parameters date spec A specification of local date in the form mm/dd/yy[yy]. The year may be expressed in two or four digits. If a date is provided, a time must also be provided. time spec A specification of local time in the form hh:mm[:ss] where seconds are optional.
Command Definitions S-SO SETCLOCK NOW This option is meaningful only when the date and time specifications are provided. NOW forces the change to be immediate. See the warning in the Operation Notes section about the dangers of changing the system time immediately. CANCEL Cancels a current time correction. Any correction which has already taken place before the cancellation will remain; this option does not undo a correction which has already been accomplished.
Command Definitions S-SO SETCLOCK On the HP3000 Universal Time (GMT) is calculated by starting with local time and adding or subtracting a time zone offset. When changing time zones (such as moving from Standard to Daylight Savings Time and back) the local time is altered, but this change must not affect Universal Time. To prevent Universal Time from being altered, both the local time and the system time zone offset must be adjusted.
Command Definitions S-SO SETCLOCK Any time during an on-going correction, issuing this command with the ;CANCEL parameter will immediately set the correction to zero and cause the system clock to resume its normal pace. Any previous correction will remain. When this option is used, the system will report the amount of correction which was cancelled. How a System Time Change Affects Accounting Information Changing the system time, even gradually, may cause accounting CONNECT-MINUTES to be distorted.
Command Definitions S-SO SETCLOCK This list is only meant to include a few of the dangers associated with an immediate time change; this list does not represent all of the problems likely to be encountered. Therefore, if the ;NOW option must be used, it should be used only with a full knowledge of its effects on the system's workload. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions S-SO SETCLOCK Examples of the Time Zone Form: Moving from Standard Time to Daylight Savings Time: The following example illustrates changing the system time zone offset from 8 hours 00 minutes in the Western Hemisphere (Pacific Standard Time) to 7 hours 00 minutes in the Western Hemisphere (Pacific Daylight Savings Time). This command will cause local time to jump forward immediately one hour. Universal Time will be unchanged.
Command Definitions S-SO SETCOUNTER SETCOUNTER Sets the next value of a specified resource counter, and optionally enables automatic rollback when a specified limit is reached. Duplicate values are avoided. Syntax SETCOUNTER[ COUNTER=] [ INSP | OUTSP | JOBNUM | SESSNUM ] [ ;BASE = num] [ ;MAX = num ] [ ;SHOW] Parameters INSP Specifies the input spoolid counter. OUTSP Specifies the output spoolid counter. JOBNUM Specifies the job number counter. SESSNUM Specifies the session number counter.
Command Definitions S-SO SETCOUNTER in force. Once MAX is reached, the next value tried is the BASE value. If you specify a non-zero value for MAX, it must be greater than the current BASE for the corresponding counter, but less than the maximum possible value The BASE keyword causes the specified counter to be immediately yanked to the specified value. If you supply a value, it must be less than the supplied or current value of MAX (other than 0), and in any case, less than the maximum possible value.
Command Definitions S-SO SETCOUNTER Manuals Chapter 7 None 555
Command Definitions S-SO SETDUMP SETDUMP Arms the system debug facility for a process abort. (Native Mode) Syntax SETDUMP[ DB [ ,ST [ ,QS] ] ] [ ;ASCII] [ ;DEBUG="commands"] Parameters DB This parameter is ignored. ST This parameter is ignored. QS This parameter is ignored. ASCII This parameter is ignored. "commands" A string of system debug commands surrounded by quotation marks. Refer to the DEBUG command in this chapter.
Command Definitions S-SO SETDUMP Example To arm the stackdump/debug facility, enter: SETDUMP Related Information Commands DEBUG, RESETDUMP Manuals System Debug Reference Manual Chapter 7 557
Command Definitions S-SO SETJCW SETJCW Creates or assigns a value to a job control word (JCW) variable. Syntax SETJCW jcwname delimiter value[ { + - } value] Parameters jcwname The name of a new or existing user-defined or system-defined job control word (JCW). You can use @ to specify all currently defined JCWs. You may not specify the system-reserved JCWs, HPMINUTE, HPHOUR, HPDAY, HPDATE, HPMONTH, or HPYEAR. delimiter One or more punctuation characters or spaces, except %, !, and -.
Command Definitions S-SO SETJCW SETJCW PROGCNTR 0 .... SETVAR PROGCNTR 65536 JCW VARIABLE RECLASSIFIED AS A STANDARD VARIABLE (CIWARN 8126) PROGCNTR is now a user-defined variable and does not function as a job control word. JCWs can be tested against specific values. The user can use IF and WHILE conditional statements that act according to the results of these tests.
Command Definitions S-SO SETJCW The result of a mathematical operation must be in the range of 0 to 65,535, inclusive; if the number is out of range, an error message is generated, and the value of the JCW remains unchanged. When the result of an operation is greater than the value of the next "step", the JCW value displayed by the SHOWJCW command will be the mnemonic of the higher step plus any offset. For example, the value OK16385 is displayed as WARN1.
Command Definitions S-SO SETJCW The following example shows the use of the CIERROR JCW: LISTF ^ UNKNOWN COMMAND NAME. (CIERR 975) SHOWJCW CIERROR CIERROR = 975 RUN ^ NO PROGRAM FILE SPECIFIED. (CIERR 600) SHOWJCW CIERROR CIERROR = 600 : System-Reserved JCWs The system-reserved JCWs are HPMINUTE, HPHOUR, HPDAY, HPDATE, HPMONTH, and HPYEAR. They contain system-assigned minute, hour, day, date, month, and year information. If the user attempts to assign values, an error message is displayed.
Command Definitions S-SO SETJCW In the following example the CONTINUE command prevents an abort in case of errors; the RUN CHEKPROG edits, verifies, and counts valid transactions; the IF command specifies that if no fatal errors occur, schedule shipments; the RUN command schedules the shipments; the ELSE command produces the error report and resets the JCW to 0; and the RUN command produces a final report: !SETJCW CHEKPROGSTAT=OK !CONTINUE !RUN CHEKPROG ! IF CHEKPROGSTAT
Command Definitions S-SO SETMSG SETMSG Enables or disables the receipt of user or operator messages at the standard list device. Syntax SETMSG{ OFF ON } Parameters OFF Sets job or session to quiet mode and blocks the receipt of TELL command messages from other users. ON Enables user or operator messages to be received and displayed at the standard list device. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions S-SO SETVAR SETVAR Assigns values to MPE/iX variables. (Native Mode) Syntax SETVAR varname{ , ; } expression Parameters varname The variable that is to be set to a value. expression The expression that is evaluated and assigned to varname. Operation Notes This command assigns values to MPE/iX variables. Variable names may be any combination of letters and numbers plus the underbar character, up to a total of 255 characters.
Command Definitions S-SO SETVAR Note that all variables are global, so the CI variable name should not be the same as the JCW name that is being used or the operation of the code that uses that JCW will be affected. Compound logical expressions can be formed using the AND, NOT, XOR, and OR logical operators, and nested within parentheses. The Boolean value of the keyword TRUE or FALSE is overridden if there is a variable of the same name.
Command Definitions S-SO SHOWALLOCATE SHOWALLOCATE Displays status information about the ALLOCATE command. Syntax SHOWALLOCATE[ STATUS[ ,listfile] ALLOCATE [ ,[ fileset] [ ,listfile] ] ALL[ ,[ fileset] [ ,listfile] ] ] Parameters STATUS Request to display a summary of status information includes: (1)Number of programs allocated; (2)Size and percentage of utilization of the following system tables: Code segment table, code segment extension block table, and loader segment table.
Command Definitions S-SO SHOWALLOCATE # specifies one numeric character. ? specifies one alphanumeric character. The characters can be used as follows: n@ All files starting with the character n. @n All files ending with the character n. n@x All files starting with the character n and ending with the character x. n##..# All files starting with the character n followed by up to seven digits (useful for listing all EDIT/3000 temporary files). ?n@ All files whose second character is n.
Command Definitions S-SO SHOWALLOCATE SPOOK5.PUB.SYS . . . . . . . . SLPATCH.PUB.SYS . . . . . . . . 1 0 NUMBER OF PROGRAMS FOUND = 2 To display summary status information regarding allocation.
Command Definitions S-SO SHOWALLOW SHOWALLOW Displays which operator commands have been allowed. Syntax SHOWALLOW[ { @.@ user.@ @.acct user.acct } ] Parameters @ All users, if used in place of user, or all accounts, if substituted for acct. Default is that the commands allowed for the logged-on user are displayed. user Defines a particular user. acct Defines a particular account. user.account Defines a particular user in a particular account.
Command Definitions S-SO SHOWCATALOG SHOWCATALOG Displays information about user-defined commands (UDCs). (Native Mode) Syntax SHOWCATALOG[ listfile] [ ;USER=username[ .acctname] ] Parameters listfile An arbitrary file name that identifies the output from SHOWCATALOG that is sent to the line printer. Specifying listfile sends the listing to device class LP (line printer). You may use a file equation to direct the listing of the catalog to a disk or tape file.
Command Definitions S-SO SHOWCATALOG Examples To display the account-level UDC files of all users in the GRIMSBY account, enter: SHOWCATALOG ;USER=@.GRIMSBY To display the system-level UDC files of all users in all accounts, enter: SHOWCATALOG ;USER=@.
Command Definitions S-SO SHOWCLOCK SHOWCLOCK Displays information about the system date and time. SYNTAX SHOWCLOCK Parameters None. Operation Notes Prints the current time, date, the time correction in effect, and the time zone. See the command SETCLOCK for information about time correction and time zone. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions S-SO SHOWDEV SHOWDEV Reports the status of input/output devices. Syntax classname ] [ ;ACD] SHOWDEV[ ldev Parameters ldev Logical device number of device for which status information is to be displayed. This number is unique for each device. Default is that status information for all system devices on the system is displayed. classname Device class name of device(s) for which status information is to be displayed. This name may apply to several devices.
Command Definitions S-SO SHOWDEV LDEV AVAIL OWNERSHIP Includes the logical device number and may include one of the following: J Accepts jobs. D Accepts data. A Accepts jobs and data. Lists the availability of devices and disks as follows: AVAIL The device is available as a real, nonshareable device. AVAIL W The device is a tape with write enable on the media. SPOOLED The device is available for input or output spooling.
Command Definitions S-SO SHOWDEV 1600 Density of 1600 BPI, or the density of the tape is unrecognizable. ASSOCIATION Indicates the logical devices by device class that have been established by the user with the ASSOCIATE command. ACD Access Control Definition. May include any of the following information per username.acctname: R READ access. W WRITE access. L LOCK access. A APPEND access. X EXECUTE access. NONE NO access. RACD Copy or read the ACD.
Command Definitions S-SO SHOWIN SHOWIN Reports the status of input device files. Syntax SHOWIN[ #Innn STATUS ] [ ;SP] [ ;item[ ;item [ ;...] ] ] Parameters #Innn Identifies the particular input device file for which information is to be displayed. Default is that MPE/iX displays information for all input device files used by the logon job or session. STATUS Summarizes the status information for all current input device files.
Command Definitions S-SO SHOWIN ACTIVE, OPENED, or READY [#]Jnnn Displays the status of all input device files for a specified job. [#]Snnn Displays the status of all input device files for a specified session. Displays the status of all input files in a specified state. ACTIVE displays the status of active device files. OPENED displays the status of opened device files. READY displays the status of ready device files.
Command Definitions S-SO SHOWIN PRI The outpriority of the device file, requested by the user or adjusted by the system operator. Specified for spooled output device files only. #C The number of copies needed, specified for spooled output device files only. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.
Command Definitions S-SO SHOWJCW SHOWJCW Displays the current state of one or more job control word (JCW) variables. Syntax SHOWJCW[ jcwname] Parameters jcwname The name of a valid job control word (JCW) variable. Default is that all user-defined and system-defined JCWs are displayed. Operation Notes The SHOWJCW command is used to display the current state of one or more job control words (JCWs). Job control words in MPE/iX are classed as variables of type JCW.
Command Definitions S-SO SHOWJCW Examples To show the current state of all user-defined and system-defined JCWs, enter: SHOWJCW JCW = 0 CIERROR = 0 To display the current state of a valid user-defined job control word named JCW1, enter: SHOWJCW JCW1 JCW1=3 To display the contents of a system-reserved JCW, enter: SHOWJCW HPDAY HPDAY=4 Related Information Commands DELETEVAR, SETJCW, SETVAR, SHOWVAR Manuals Appendix A, "Predefined Variables in MPE/iX" 580 Chapter 7
Command Definitions S-SO SHOWJOB SHOWJOB Displays status information about jobs/sessions. Syntax SHOWJOB[ [ #] Snnn [ #] Jnnn STATUS SCHED item[ ;item[ ;...] ] ] [ ;*listfile] [ ;JOBQ] Parameters #Snnn The session number (assigned by MPE/iX) of the session for which the status information is to be displayed. The information appears in Type I format, described under "Operation Notes." Default is that the status information for all jobs/sessions is displayed.
Command Definitions S-SO SHOWJOB Parameters for Item A list of jobs/sessions for which status information is to be displayed. Use one of the following options: JOB= @J Displays status information for all jobs. @S Displays status information for all sessions. @ Displays status information for all jobs and sessions. Default. [jsname,] username. acctname The jsname is an optional name given to the session or job by the user. The username parameter is the user name established by the account manager.
Command Definitions S-SO SHOWJOB 7 JOBS: 0 INTRO 0 WAIT; INCL 0 DEFERRED 7 EXEC; INCL 7 SESSIONS 0 SUSP JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16 If the SHOWJOB SCHED command is used, the output is displayed as shown below. The STATE field shows that the job is scheduled. The SCHEDULED-INTRO field shows the time and date the job will be introduced to the system. Note that the scheduled jobs are listed in the order in which they will be introduced to the system.
Command Definitions S-SO SHOWJOB JOBNUM STATE IPRI JLIST JOBQ INTRODUCED JOB NAME #J3 EXEC LP HPSYSJQ WED 11:46A FTPMON,FTP.SYS #J7 EXEC LP SYSMGRQ WED 5:47P EMG,MGR.SYSMGR #S81 EXEC 34 THU 12:17P MGR.
Command Definitions S-SO SHOWLOG SHOWLOG Displays the number of the system's current log file and the percentage of disk space used. (Native Mode) Syntax SHOWLOG Parameters None. Operation Notes The log file number, xxxx, and percentage of file space used, yy, is displayed in the format: SYSTEM LOG FILE #xxxx IS yy% FULL If the logging system is disabled, MPE/iX displays the message: NO LOGGING If logging is enabled but currently suspended due to an error, both messages are displayed.
Command Definitions S-SO SHOWLOGSTATUS SHOWLOGSTATUS Displays status information about currently opened user logging files assigned to a logging identifier. Syntax SHOWLOGSTATUS[ logid] Parameters Displays status of the user logging file associated with the logging identifier, logid, created by the GETLOG command. Default is that the status of all logging identifiers is displayed. logid Operation Notes This command lists the status of currently running logging processes.
Command Definitions S-SO SHOWLOGSTATUS CUR-F The current file number in the set. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. Example Refer to "Operation Notes.
Command Definitions S-SO SHOWME SHOWME Reports the status of a job or session. (Native Mode) Syntax SHOWME Parameters None. Operation Notes To display the status of the current job/session enter: SHOWME USER: #S485,MGR.DSUSER,PUB (NOT IN BREAK) RELEASE: V.UU.FF MPE XL HP31900 A.11.70 USER VERSION: V.UU.
Command Definitions S-SO SHOWME CURRENT Shows the current time and date. LOGON Shows the logon time. CPU SECONDS Shows the central processor time (CPU) used by this job/session. NOTE SHOWME calculates CPU usage by adding the local CPU usage of the current process to the accumulated total of all terminated processes. The CPU usage listed for a programmatic SHOWME, therefore, would rarely agree with that for a SHOWME executed during BREAK.
Command Definitions S-SO SHOWOUT SHOWOUT Displays the status of output device files. Syntax SHOWOUT[ { #Onnn STATUS SP item[ ;item[ ;...] ] } ] Parameters #Onnn Identifies a particular output device file for which you want information. The information is displayed in Type I format, which is described in the "Operation Notes" section of this command. The default is to display status information for all output device files used by the logon job or session.
Command Definitions S-SO SHOWOUT JOB= Displays the status of output device files using one of the following options: @J Displays the status of output device files for all jobs. @S Displays the status of output device files for all sessions. @ Displays the output device files for all jobs and sessions. [#]Jnnn Displays all output device files for specified job. [#]Snnn Displays the status of all output device files for a specified session.
Command Definitions S-SO SHOWOUT DFID Device file identification, which begins with the letter O (not zero) followed by a number. The numeric portion of the DFID is identical to the LDEV number of the device. JOBNUM The job/session number (jsnum) of job or session using the device file. FNAME File name assigned to device file. STATE The status, indicated by one of the following subparameters: ACTIVE The spooled device file on disk is actually being written to a printer or plotter.
Command Definitions S-SO SHOWOUT Use This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.
Command Definitions S-SO SHOWPROC SHOWPROC Displays information about the specified process(es). (Native Mode) Syntax SHOWPROC[ [ PIN=]{pinspec | (pinspec [ ,pinspec ] ...)}] [[;JOB=]{jobspec | (jobspec [ ,jobspec] ...)}] [[;FORMAT=]{SUMMARY | DETAIL}] [{;TREE | ;NOTREEE}] [{;USER | ANYUSER}] [{;SYSTEM}] [{;TRUNC | ;NOTRUNC}] Parameters pinspec The process that you want to see. The pinspec, expressed [#p ]pin, is a Process Identification Number (PIN).
Command Definitions S-SO SHOWPROC An ordinary user can only see their own processes, even when jobspec is wildcarded. For example, if the user name is JEFF.MFG and you enter the command as shown below, then only processes for jobs logged on as JEFF.MFG are displayed. :SHOWPROC job=@J On the other hand, if the user STEVE.UI (who has OP or SM capability) enters the command shown below, then all processes for all jobs on the system are displayed. :SHOWPROC job=@J If the user STEVE.
Command Definitions S-SO SHOWPROC ANYUSER This option defeats the filtering of the wildcarded jobspec and displays all matching processes. SM or OP capability is necessary to specify ANYUSER, and users with these capabilities get ANYUSER by default. OP or SM users may reduce the SHOWPROC output to just their own processes by using the USER option. TRUNC The TRUNC option truncates output records that would exceed the record width of $STDLIST for the user.
Command Definitions S-SO SHOWPROC LOGON (v): The job/session, user, and account name associated with this process. PARENT (5): Process Identification Number for the process' parent (decimal). This field is unique to the DETAIL format. The DETAIL format displays PARENT so that process relationships can be determined. A zero indicates that the process does not have a parent (for example, PROGEN). PIN (5): Process Identification Number for the process (decimal).
Command Definitions S-SO SHOWPROC :SHOWPROC pin=(2,99,121,188);format=detail;system PIN PARENT PRI CPUTIME STATE 2 1 142 L 7:23.687 WAIT JOBNUM (PROGRAM) STEP - (LOAD.PUB.SYS) LOGON : PROGRAM : LOAD.PUB.SYS QUEUE : BS WORKGROUP : BS_Default *********************** PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP 99 68 160 L 0:05.020 BLKIO S45 (QEDIT.PUB.SYS) - LOGON : NMTEST,SLC.MYTEST PROGRAM : QEDIT.PUB.
Command Definitions S-SO SHOWPROC C152 0:02.000 WAIT S12 C152 0:01.030 READY S12 r;new 38 (TDP.PUB.SYS) text myfile (FCOPY.PUB.SYS)from=foo.pub.
Command Definitions S-SO SHOWQ SHOWQ Displays scheduling data for all processes and the scheduling characteristics of the CS, DS and ES scheduling subqueue(s). (Native Mode) SYNTAX SHOWQ[ ;ACTIVE] [ ;STATUS] Parameters ACTIVE Displays only the processes currently running or those about to run. This is the right-hand portion of the display. The STATUS lines are printed last. STATUS Reduces the output from SHOWQ to the final status lines of display (base and limit priorities, quantum bounds).
Command Definitions S-SO SHOWQ Each entry in the three columns displays the following information for a single process; the meaning is explained below.
Command Definitions S-SO SHOWQ Example To display the active processes and the current scheduling subqueue characteristics, enter: :SHOWQ;ACTIVE DORMANT Q PIN JOBNUM RUNNING Q PIN JOBNUM C M163 #S263 C U215 #S256 QUANTUM QUEUE BASE LIMIT MIN MAX ACTUAL BOOST TIMESLICE - - - - CQ 152 200 1 2000 200 DECAY 200 DQ 202 238 2000 2000 2000 OSC 200 EQ 240 253 2000 2000 2000 DECAY 200 Related Information Commands TUNE, ALTPROC, SHOWPROC, NEWWG, ALTWG, PURGEWG, SHOWWG Manuals MPE/iX Intrinsics Reference Manual
Command Definitions S-SO SHOWTIME SHOWTIME Prints current time and date. (Native Mode) Syntax SHOWTIME Parameters None. Operation Notes Prints current time and date, as indicated by system clock. Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.
Command Definitions S-SO SHOWVAR SHOWVAR Displays specific variable names and their current values. (Native Mode) Syntax SHOWVAR[ varid] [ ,varid] ... [ ,varid] [job= jobID] [;USER | HP | ANY] Parameters varid The name of the variable for which the current value is to be displayed. jobid The job or session number who’s variables are to be displayed. Example: #J123 or S4321. SM capability is required to see the variables from another job or session.
Command Definitions S-SO SHOWVAR Table 7-2 Specified Variable-ID/Result Variable-ID Displays (omitted) All variables and values that the user has set. @ All variables. A,B,C Values for variables A, B, and C. B@ All variables whose names begin with B. You may use the wildcard characters @, #, ?, and [ ] to specify a set or range of variables or file names in many commands. @ Specifies zero or more alphanumeric characters, or the underbar character (_).
Command Definitions S-SO SHOWVAR To display all variables created by the user with the SETVAR, INPUT, or SETJCW command, or with the HPCIPUTVAR, PUTJCW, or SETJCW intrinsics, enter: SHOWVAR To display all variables created currently in the variable table, those created by the user and all predefined variables, enter: SHOWVAR @ To display all user-defined variables for session 32. Must have SM capability, enter: SHOWVAR ;job=#s32 To display all user-defined variables matching s@ for job 23.
Command Definitions S-SO =SHUTDOWN =SHUTDOWN Initiates a shutdown of MPE/iX. Syntax =SHUTDOWN[ system terminal dtc tape disc network other ] Parameters None. Operation Notes The =SHUTDOWN command performs an implicit =LOGOFF of all sessions, including the session logged at the system console. All system processes are stopped in an orderly fashion.
Command Definitions S-SO =SHUTDOWN Use This command may be issued only at the physical console. Example To shut the system down, first issue a warning to all users to allow them time to log off, and then execute =SHUTDOWN as shown below: WARN @;SYSTEM WILL SHUTDOWN IN FIVE MINUTES. PLS LOG OFF. CTRL A =SHUTDOWN 10:49/#S40/25/LOGOFF 10:49/20/ALL JOBS LOGGED-OFF To shut down the system in order to identify a DTC hang, use the dtc option.
Command Definitions S-SO SHUTQ SHUTQ Closes the spool queue(s) for the specified logical device, device name, or all members of a device class. (Native Mode) Syntax SHUTQ{ ldev[ ;SHOW] devclass[ ;SHOW] devname[ ;SHOW] @ } Parameters ldev The logical device number of the device. devclass The device class name of the devices. devname The device name of the device. Note that it is not possible to have a device class name and a device name that are the same.
Command Definitions S-SO SHUTQ Examples To shut the queue for all devices in class LP, enter: SHUTQ LP To shut the spool queue and show the state of the queue and other information about the specified device, enter: SHUTQ 6;SHOW Related Information Commands OPENQ, STARTSPOOL, SPOOLER Manuals Native Mode Spooler Reference Manual Performing System Operation Tasks 610 Chapter 7
Command Definitions SP-Z 8 Command Definitions SP-Z Chapter 8 611
Command Definitions SP-Z SPEED SPEED Sets the input and output speed for the user's terminal. Syntax SPEED newinspeed, newoutspeed or SET SPEED = newspeed Parameters newinspeed The new input speed in characters-per-second (CPS). The input and output speeds must always be equal. Acceptable values for newinspeed and newoutspeed are 30, 120, 240, 480, 960, and 1920. newoutspeed The new output speed in characters-per-second (CPS). The input and output speeds must always be equal.
Command Definitions SP-Z SPEED Use This command may be issued from a session, program, or in BREAK. This command is not available from a job. Pressing Break has no effect on this command.
Command Definitions SP-Z SPL SPL Compiles a compatibility mode SPL/V program. SPL/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. Syntax SPL[ textfile] [ ,[ uslfile] [ ,[ listfile] [ ,[ masterfile] [ ,newfile] ] ] ] [ ;INFO=quotedstring] Parameters textfile Actual file designator of the input file from which the source program is read. This can be any ASCII input file. The formal file designator is SPLTEXT. Default is $STDIN.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
Command Definitions SP-Z SPL Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written. newfile NOTE The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list.
