HP HP 3000 - Manuals

Chapter 1 13 Commands by Task 1 Commands by Task Commands are used to communicate with the MPE/iX operating system. They requestMPE/iX to perform a specific task or provide specific information.

14 Chapter 1 Commands by Task Task-Related Commands Task-Related Commands This chapter is an introduction to MPE/iX commands and their functions, categorized bythe task they perform. The categories of tasks identified for MPE/iX commands are: • Accessing Subsystems and Utilities. • Command Interpret...

Chapter 1 15 Commands by Task Task-Related Commands Check that list to find an appropriate functional description, which in this case is "Createsa new account". Then check the lefthand column for the name of the command thatperforms that function, which in this case is NEWACCT . When you hav...

16 Chapter 1 Commands by Task Task-Related Commands RETURN Causes execution to return from the current user command (UDC orcommand 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 Ot...

Chapter 1 17 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 dev...

18 Chapter 1 Commands by Task Task-Related Commands LISTFILE Lists file information using native mode scanning/parsing that can beeasily expanded. LISTFTEMP Displays information about temporary files. NEWDIR Creates a directory NEWLINK Creates a symbolic link PRINT Prints the contents of a file. PUR...

Chapter 1 19 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 toexecute. JOBPRI Sets or changes...

20 Chapter 1 Commands by Task Task-Related Commands OUTFENCE Defines the minimum priority an output spoolfile needs in order to beprinted. RESUMESPOOL Resumes suspended spooler output to a spooled device. STARTSPOOL Initiates the spooler process for a device. SHUTQ Closes the spool queue for a speci...

Chapter 1 21 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 mustrelinquish the CPU. Managing User/System Logging ALTLOG Alte...

22 Chapter 1 Commands by Task Task-Related Commands LDISMOUNT Causes a volume set that was reserved system-wide by the user to bereleased. LMOUNT Reserves a volume set system-wide. MOUNT Reserves an online volume set. VMOUNT Enables/disables the MPE/iX movable volume facility. VOLTIL Defragment disk...

Chapter 2 25 Command Definitions A-B 2 Command Definitions A-B This chapter provides information on MPE/iX commands. For your convenience, they arearranged in alphabetical order. Each command specification contains the followinginformation: Command Name Provides the command name at the top of each p...

Chapter 2 27 Command Definitions A-B Commands and Parameters Commands and Parameters MPE/iX commands tell the computer to perform a specific function. The parameters youenter for each command tell the computer to perform the function in a specific way.MPE/iX uses four classifications of parameters: ...

28 Chapter 2 Command Definitions A-B Commands and Parameters Positional Parameters The meaning of a positional parameter depends upon its position (location) in theparameter list. In the syntax diagrams for each command in this chapter, positionalparameters are separated from each other by a comma (...

30 Chapter 2 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 theirdefinition. This means that the command is parsed by the Native Mode CommandParser. If Native Mode is not specified, the ...

Chapter 2 31 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 andkeyword specifications, for example: COMMAND A,B;KEYWORD3=C There is one important rule to remember when yo...

32 Chapter 2 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 advi...

Chapter 2 33 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 ...

34 Chapter 2 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 specifyingparameters, as defined below. Also the ECHO command accepts all delimiters and treats them as part of the value ...

Chapter 2 35 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 betreated as any other character. For more information on the use of quotes,...

36 Chapter 2 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 callingintrinsics refer to the MPE/i...

Chapter 2 37 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 wayyou would any other program, either by explicitly using the RUN command (the first example below), or by using the the impl...

38 Chapter 2 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 ...

Chapter 2 39 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 onepending I/O request. Operation Notes This command abor...

40 Chapter 2 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/3...

Chapter 2 41 Command Definitions A-B ABORTJOB/ =ABORTJOB ABORTJOB/ =ABORTJOB Aborts a job or session. Syntax ABORTJOB { #J nnn #S nnn [ jobname ,] user . acct } =ABORTJOB { #J nnn #S nnn [ jobname ,] user . acct } Parameters #J nnn A job number. #S nnn A session number. jobname The name of the job, ...

42 Chapter 2 Command Definitions A-B ABORTJOB/ =ABORTJOB The standard error message that appears when a request is manually terminated byentering 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 phy...

Chapter 2 43 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...

44 Chapter 2 Command Definitions A-B ACCEPT Examples To permit logical device 19 to accept jobs and data, enter: ACCEPT 19SHOWDEV 19 LDEV AVAIL OWNERSHIP VOLID ASSOCIATION 19 AVAIL To permit logical device 19 to accept jobs and data, and to allow the device to be spooled,enter: ACCEPT 19STARTSPOOL 1...

Chapter 2 45 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 allocat...

46 Chapter 2 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 v...

Chapter 2 47 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 ...

48 Chapter 2 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=ALLO...

50 Chapter 2 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 ] ] [ ...

Chapter 2 51 Command Definitions A-B ALTACCT If a capability is removed at the account level, users within the account arealso denied that capability. No explicit change to the user's capabilities isnecessary. Similarly, if a capability is returned to the account, any userswith that capability regai...

Chapter 2 53 Command Definitions A-B ALTACCT Table 2-2 Default Parameters for the ALTACCT Command Any value changed with the ALTACCT command takes effect the next time MPE/iX is requested to check the value. If an attribute is removed from an account while users arelogged on, they are not affected u...

54 Chapter 2 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=OMSBOROSALTACCT MALCHIOR;ONVS=TIME_LORD;FILES=20000 You must specify the changes for the system vol...

Chapter 2 55 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 ...

56 Chapter 2 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 ...

Chapter 2 57 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= volum...

60 Chapter 2 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 Comma...

Chapter 2 61 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. Related Information Commands ALTACCT , ALTUSER Manuals Volume Management Reference Manual

62 Chapter 2 Command Definitions A-B ALTJOB ALTJOB Alters the attributes of waiting or scheduled jobs. (Native Mode) Syntax ALTJOB[ JOB=] { #Jnnn #Snnn } [ ;INPRI= inputpriority ] [ ;OUTDEV={ l dev devclass } ] [.HIPRI][;JOBQ=queuename] Parameters #J nnn A job number. #S nnn A session number. (Altho...

64 Chapter 2 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 identifiermu...

66 Chapter 2 Command Definitions A-B ALTPROC ALTPROC Changes characteristics of the specified processes. Currently, a process' priority, queueattribute, and workgroup may be changed. (Native Mode) Syntax ALTPROC[ [ PIN=] { pinspec ( pinspec [ ,pinspec ] ...) } [ ;JOB=] { jobspec ( jobspec [ ,jobspec...

Chapter 2 67 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 ign...

Chapter 2 69 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...

70 Chapter 2 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, anddevices. ACDs are automatically assigned to hierarchical directories an...

Chapter 2 71 Command Definitions A-B ALTSEC MPE Syntax You can include MPE file name Syntax but not RFA information. If theobject is an MPE Syntax file, its format is: filename [/ lockword ][. groupname [. acctname ]] You may specify file lockwords for files protected by active lockwordsunless the o...

Chapter 2 75 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 ...

76 Chapter 2 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=(...

Chapter 2 77 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 #O nnn The output device file identification of a spoolfi...

78 Chapter 2 Command Definitions A-B ALTSPOOLFILE You may alter the outputpriority or the numcopies of an ACTIVE spoolfile withoutinterrupting the printing process. If you alter the device or defer the ACTIVE spoolfilewith the DEFER parameter, the printer stops immediately. In both cases, the entire...

Chapter 2 79 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 ] [ ...

80 Chapter 2 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...

Chapter 2 81 Command Definitions A-B ALTUSER Opt USERPASS=OPT specifies that users in this account may or may not havepasswords. If you do not use the USERPASS parameter, the old valueremains. It is available only if the HP Security Monitor has been installed. Expired The password expires immediatel...

82 Chapter 2 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 ...

Chapter 2 83 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 ...

Chapter 2 85 Command Definitions A-B BASIC BASIC Interprets a compatibility mode BASIC/V program. BASIC/V is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. Syntax BASIC[ commandfile ] [ ,[ inputfile ] [ , listfile ] ] Parameters comm...

86 Chapter 2 Command Definitions A-B BASIC Examples To enter commands and data from your standard input device, with program listing andoutput transmitted to the standard output device, enter: BASIC You may also submit commands and data to the BASIC/V interpreter through input filesthat you have sto...

Chapter 2 87 Command Definitions A-B BASICGO BASICGO Compiles, prepares, and executes a compatibility mode BASIC/V program. BASIC/V is notpart of the HP 3000 Series 900 Computer System Fundamental Operating Software andmust be purchased separately. Syntax BASICGO[ commandfile ] [ , listfile ] Parame...

88 Chapter 2 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 t...

Chapter 2 89 Command Definitions A-B BASICOMP BASICOMP Compiles a compatibility mode BASIC/V program. BASIC/V is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. Syntax BASICOMP[ commandfile ] [ ,[ uslfile ] [ , listfile ] ] Parameters...

90 Chapter 2 Command Definitions A-B BASICOMP example, below. You may, however, build a USL file in the permanent file domain, thendirect the BASIC/V compiler to store the object code in this file by naming the USL file inthe BASICOMP command line. Refer to "Examples." Use This command may b...

Chapter 2 91 Command Definitions A-B BASICPREP BASICPREP Compiles and prepares a compatibility mode BASIC/V program. BASIC/V is not part of theHP 3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. Syntax BASICPREP[ commandfile ] [ ,[ progfile ] [ , listfi...

Chapter 2 93 Command Definitions A-B BBASIC BBASIC Starts execution of the HP Business BASIC/V interpreter in compatibility mode. HPBusiness BASIC/V is not part of the HP 3000 Series 900 Computer System FundamentalOperating Software and must be purchased separately. Syntax BBASIC[ commandfile ] [ ,[...

94 Chapter 2 Command Definitions A-B BBASIC You may also submit commands and data to the HP Business BASIC/V interpreterthrough input files that you have stored on disk. Files created using the editor must bekept with the UNN (unnumbered) option of the editor's KEEP command. In this example, HP Busi...

Chapter 2 95 Command Definitions A-B BBASICGO BBASICGO Compiles, prepares, and executes an HP Business BASIC/V program in compatibilitymode. HP Business BASIC/V is not part of the HP 3000 Series 900 Computer SystemFundamental Operating Software and must be purchased separately. Syntax BBASICGO infil...

Chapter 2 97 Command Definitions A-B BBASICOMP BBASICOMP Compiles an HP Business BASIC/V program in compatibility mode. HP Business BASIC/Vis not part of the HP 3000 Series 900 Computer System Fundamental Operating Softwareand must be purchased separately. Syntax BBASICOMP infile [ ,[ uslfile ] [ , ...

98 Chapter 2 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 t...

Chapter 2 99 Command Definitions A-B BBASICPREP BBASICPREP Compiles and prepares an HP Business BASIC/V program in compatibility mode. HPBusiness BASIC/V is not part of the HP 3000 Series 900 Computer System FundamentalOperating Software and must be purchased separately. Syntax BBASICPREP infile [ ,...

Chapter 2 101 Command Definitions A-B BBXL BBXL Initiates execution of the HP Business BASIC/XL interpreter. HP Business BASIC/XL isnot part of the HP 3000 Series 900 Computer System Fundamental Operating Softwareand must be purchased separately. (Native Mode) Syntax BBXL[ commandfile ] [ ,[ inputfi...

Chapter 2 103 Command Definitions A-B BBXLCOMP BBXLCOMP Compiles an HP Business BASIC/XL program. HP Business BASIC/XL is not part of theHP 3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. (Native Mode) Syntax BBXLCOMP textfile [ ,[ objectfile ] [ , lis...

104 Chapter 2 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 FILECommands for Subsystems"...

Chapter 2 105 Command Definitions A-B BBXLCOMP Manuals HP Business BASIC/XL Migration Guide HP Business BASIC/XLReference Manual

106 Chapter 2 Command Definitions A-B BBXLGO BBXLGO Compiles, links, and executes an HP Business BASIC/XL program. HP BusinessBASIC/XL is not part of the HP 3000 Series 900 Computer System FundamentalOperating Software and must be purchased separately. (Native Mode) Syntax BBXLGO textfile [ ,[ listf...

Chapter 2 107 Command Definitions A-B BBXLGO Use This command may be issued from a session, job, or program. It may not be used inBREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.

108 Chapter 2 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 H...

Chapter 2 109 Command Definitions A-B BBXLLK BBXLLK Compiles and links an HP Business BASIC/XL program. HP Business BASIC/XL is notpart of the HP 3000 Series 900 Computer System Fundamental Operating Software andmust be purchased separately. (Native Mode) Syntax BBXLLK textfile [ ,[ progfile ] [ , l...

Chapter 2 111 Command Definitions A-B BREAKJOB BREAKJOB Suspends an executing job. (Native Mode) Syntax BREAKJOB #J nnn Parameters #J nnn 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 ...

Chapter 2 115 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 repli...

Chapter 2 117 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 l...

118 Chapter 2 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 ASCI...

Chapter 2 119 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, MA...

Chapter 3 121 Command Definitions C-E 3 Command Definitions C-E

122 Chapter 3 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 expressio...

Chapter 3 123 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. Examp...

124 Chapter 3 Command Definitions C-E CCXL CCXL Compiles an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 ComputerSystem Fundamental Operating Software and must be purchased separately. Thiscommand is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXL ...

126 Chapter 3 Command Definitions C-E CCXL Examples The following example compiles an HP C/iX program entered from your standard inputdevice 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 pr...

Chapter 3 127 Command Definitions C-E CCXLGO CCXLGO Compiles, links, and executes an HP C/iX program. HP C/iX is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. This command is recognized only if HP C/iX is installed on your system.(N...

Chapter 3 129 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 900Computer 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...

Chapter 3 131 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 containfrom one to eight alphanumeri...

132 Chapter 3 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 anddisplays an appropriate message. However, by specifying the AUTO parameter in a GETLOG or ALTLOG comm...

134 Chapter 3 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 bean MPE name unless you specify otherwis...

Chapter 3 135 Command Definitions C-E CHDIR 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. You must have traverse directory entries (TD) permission to each directory component in dir_name (refer to the ALTSEC command ...

Chapter 3 137 Command Definitions C-E CHGROUP CHGROUP Switches you from the current group to another group within the logon account to whichyou are allowed access. (Native Mode) Syntax CHGROUP [ [ groupname ] [ / grouppass ] ] NOTE This command follows the optional MPE/iX command line syntax. Refer ...

138 Chapter 3 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 ...

142 Chapter 3 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. For example, if you have created a program called MAIN and a subprogram called SUB , each c...

Chapter 3 143 Command Definitions C-E COB74XLG COB74XLG Compiles, links, and executes an HP COBOL II/iX program using the ANSI 1974 standardentry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer SystemFundamental Operating Software and must be purchased separately. This command i...

144 Chapter 3 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 &BOUND...

Chapter 3 145 Command Definitions C-E COB74XLG Examples To compile, link, and execute an HP COBOL II/iX program entered from your standardinput 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...

148 Chapter 3 Command Definitions C-E COB74XLK Examples To compile and link an HP COBOL II/iX program entered from your standard input devicewith 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 ...

150 Chapter 3 Command Definitions C-E COB85XL Refer to the HP COBOL/XL Programmer's Guide (31500-90002) forinformation 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 orexisting object file ...

Chapter 3 159 Command Definitions C-E COBOLII COBOLII Compiles a compatibility mode COBOLII program on the COBOL 74 compiler. COBOLII isnot part of the HP 3000 Series 900 Computer System Fundamental Operating Softwareand must be purchased separately. The native mode equivalent of this command is COB...

162 Chapter 3 Command Definitions C-E COBOLIIGO COBOLIIGO Compiles, prepares, and executes a compatibility mode COBOLII program on the COBOL74 compiler. COBOLII is not part of the HP 3000 Series 900 Computer SystemFundamental Operating Software and must be purchased separately. The native modeequiva...

164 Chapter 3 Command Definitions C-E COBOLIIPREP COBOLIIPREP Compiles and prepares a compatibility mode COBOLII program on the COBOL 74compiler. COBOLII is not part of the HP 3000 Series 900 Computer System FundamentalOperating Software and must be purchased separately. The native mode equivalent o...

166 Chapter 3 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 characteris an ampersand ( & ), comment text is contin...

Chapter 3 167 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 devi...

168 Chapter 3 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 theconsole. To change the location of the console, this command must be issued...

Chapter 3 169 Command Definitions C-E CONTINUE CONTINUE Overrides a job error so that the job or user command (command file or UDC) continuesexecuting. (Native Mode) Syntax CONTINUE Parameters None. Operation Notes The CONTINUE command permits a job or session to continue even though the command imm...

Chapter 3 171 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 capabiliti...

Chapter 3 173 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 C...

174 Chapter 3 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...

Chapter 3 175 Command Definitions C-E DATA Operation Notes This command identifies data to be read from a device file other than your standardjob/session input device. It can be used, for example, to input a data file from a spooledinput device for later use by an interactive session or a batch job....

Chapter 3 177 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 se...

Chapter 3 179 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 debuggerprompt is displayed. The string may be as many as 255 characters long.Th...

Chapter 3 181 Command Definitions C-E DELETESPOOLFILE DELETESPOOLFILE Deletes a spoolfile from disk. Syntax DELETESPOOLFILE { #O nnn #I nnn ldev } Parameters #O nnn The identification of a READY or ACTIVE output spoolfile. #I nnn The identification of a READY, input spooled data file. ldev The logic...

182 Chapter 3 Command Definitions C-E DELETESPOOLFILE When you put the device back online, the trailer page is printed, and the file deleted. If youhave suppressed header/trailer output with the HEADOFF command, no trailer is printed before the spoolfile is deleted. However, the printer skips to the...

Chapter 3 183 Command Definitions C-E DELETEVAR DELETEVAR Deletes one or more MPE/iX variables. (Native Mode) Syntax DELETEVAR varname [ , varname ] ... [ , varname ] NOTE This command follows the optional MPE/iX command line syntax. Refer to"Optional Format for MPE/iX Commands" at the begin...

Chapter 3 185 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...

186 Chapter 3 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 thecommands which may be allowed. Ref...

188 Chapter 3 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 removin...

Chapter 3 189 Command Definitions C-E DISCRPS DISCRPS Enables or disables the rotational position sensing (RPS) feature on a specified logicaldevice. It requires a special firmware upgrade CS-80 disk drives. Syntax DISCRPS ldev { ,ENABLE [ { , value,value } ] ,DISABLE } Parameters ldev The logical d...

190 Chapter 3 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,ENABLESHOWDEV 1 LDEV AVAIL OWNERSHIP VOID DEN ASSOCIATION 1 DISC (RPS) 50 FILES To use the value parameter with ENABLE to set time-to-target a...

192 Chapter 3 Command Definitions C-E DISCUSE (UDC) Refer to the DISKUSE command later in this chapter for additional examples. Related Information Commands DISKUSE , LISTFILE , REPORT

Chapter 3 193 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...

Chapter 3 195 Command Definitions C-E DISKUSE Examples The illustration below shows a hierarchical directory structure, upon which all of thesucceeding 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 ...

Chapter 3 197 Command Definitions C-E DISKUSE NOTE The output is presented in HFS syntax, even if the directory name is suppliedin MPE syntax. If wildcards were used to specify the directory name in MPEsyntax, then the final line of output is the user-supplied directory name(upshifted) in MPE format...

198 Chapter 3 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 ...

200 Chapter 3 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.C Related Information Commands MOUNT , LMOUNT , DSTAT , VS...

Chapter 3 201 Command Definitions C-E DO DO Allows the user to reexecute any command still retained in the command line historystack. It also permits the user to edit the command before reexecuting it, but withouthaving to use the interactive mode of the REDO command. (Native Mode) Syntax DO [ CMD= ...

204 Chapter 3 Command Definitions C-E DO NOTE A word is defined as a grouping of characters delimited by a space, comma,semicolon, =, (, ), “ , ‘, tab. Operation Notes Reexecutes the command specified by cmdid . The user may specify an optional edit string to edit the command before it is reexecuted...

Chapter 3 207 Command Definitions C-E DOIONOW DOIONOW Executes the changes to the I/O configuration made with the SYSGEN utility, while thesystem remains online. Syntax DOIONOW Parameters None. Operation Notes Use the DOIONOW command to start the online reconfiguration of your I/O devices. Use This ...

208 Chapter 3 Command Definitions C-E DOWN DOWN Removes a device from normal system use. This command does not apply to the systemconsole 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 f...

210 Chapter 3 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 HP2608 or HP 2563 Line Printer. filename The fully qu...

Chapter 3 211 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 tousers with the ALLOW or ASSOCIATE command. Examples To respond to a forms...

212 Chapter 3 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 whosestatus is requested. ALL Displays the status of all disk dri...

Chapter 3 213 Command Definitions C-E DSTAT If you have purchased Mirrored Disk/XL, you may see PENDING or DISABLED as well. PENDING indicates the partner disk failed to mount; DISABLED indicates the volume is not abailable to the system due to a disk failure. If you have Mirrored Disk/XL you also m...

214 Chapter 3 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 comman...

216 Chapter 3 Command Definitions C-E EDITOR EDITOR Starts the EDIT/3000 subsystem, which is used to create and manipulate ASCII text orprogram files. Syntax EDITOR [ listfile ] Parameters listfile Actual file designator of file to receive any output resulting fromEDIT/3000 LIST and XPLAIN commands ...

Chapter 3 217 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...

218 Chapter 3 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...

220 Chapter 3 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 exp...

Chapter 3 221 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 ev...

222 Chapter 3 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 NOTE The "&" symbol ...

224 Chapter 3 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 recordsbecause the CI is not involved at that point. Parameters None. Operation Notes The EOJ command terminates a batch job and ...

Chapter 3 225 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. Parame...

226 Chapter 3 Command Definitions C-E ERRDUMP ERRDUMP Allows a user to dump either the process or system error stack to a specified depth. (NativeMode) Syntax ERRDUMP [ errorstackdepth ] [ ;SYS] NOTE This command follows the optional MPE/iX command line syntax. Refer to"Optional Format for MPE/i...

Chapter 3 227 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. F...

228 Chapter 3 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 . Operatio...

230 Chapter 3 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 asa program. To do so, you enter CI.PUB.SYS , or simply CI . If you enter th...

Chapter 4 231 Command Definition F-K 4 Command Definition F-K

232 Chapter 4 Command Definition F-K FCOPY FCOPY Invokes the FCOPY subsystem. Syntax FCOPY [ fcopycommand ] Parameters fcopycommand An FCOPY subsystem command. The FCOPY subsystem enables you tocopy files or selected portions of files from any supported input device toany supported output device. Th...

234 Chapter 4 Command Definition F-K FILE FILE Declares the file attributes to be used when a file is opened. This declaration, informallyknown as a file equation, may be used to override programmatic or system default filespecifications. With the addition of shared parameters from the NS3000/XL Adv...

238 Chapter 4 Command Definition F-K FILE If you are opening a file that is to reside on a movable volume set, youmust specify a device class that includes the drives upon which the homevolume set is mounted. The file is then allocated to any of the volume set'svolumes that fall within that device c...

Chapter 4 239 Command Definition F-K FILE Parameters for Option recsize Record size. A positive number indicates words; a negative numberindicates bytes for new files only. For fixed-length files, this is the logicalrecord size. For undefined length files, this is the maximum record size.For variabl...

240 Chapter 4 Command Definition F-K FILE The density value from a file equation takes precedence over the densityspecified 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/i...

Chapter 4 241 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 di...

242 Chapter 4 Command Definition F-K FILE keysize Length of the KSAM key, in bytes. This parameter is required for all keytypes. Different keytypes have different lengths, as described below: DUP or RDUP These two options apply only to KSAM files. Specify the DUP option if you want duplicate key val...

Chapter 4 243 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 bein...

Chapter 4 245 Command Definition F-K FILE formid Applies only to output spoolfiles. A string of up to eight alphanumericcharacters, beginning with a letter, which uniquely identifies a specialform that is to be mounted. A message displaying this formid is printed on the system console or $STDLIST of...

246 Chapter 4 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 wayfor commands and code outside your program to reference the file. The FILE comman...

Chapter 4 247 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=-80FTNXL *SOURCE Implicitly, the command executor issues the fo...

250 Chapter 4 Command Definition F-K FORMSALIGN FORMSALIGN Configures one spooled printer or a group of spooled printers related by device class, toconditionally enter into a forms message dialog with its operator (s) when the currentspoolfile includes a forms message. Syntax FORMSALIGN[DEV=]{ldev |...

Chapter 4 251 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 messagedialog is not activated. Identical formids override all other considerations. Note that the DIALOG option is ...

254 Chapter 4 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 FundamentalOperating Software and must be purchased separately. Syntax FORTGO [ textfile ] [ ,[ listfile ] ...

Chapter 4 255 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 inBREAK. Pre...

256 Chapter 4 Command Definition F-K FORTPREP FORTPREP Compiles and prepares a compatibility mode FORTRAN 66/V program. FORTRAN 66/V isnot part of the HP 3000 Series 900 Computer System Fundamental Operating Softwareand must be purchased separately. Syntax FORTPREP [ textfile ] [ ,[ progfile ] [ ,[ ...

260 Chapter 4 Command Definition F-K FORTRAN To compile a FORTRAN 66/V program and store the object code into a USL file you createwith the BUILD command, enter: BUILD OBJECT;CODE=USLFORTRAN SOURCE,OBJECT,LISTFL To create a USL file with the BUILD command, the code must be specified. Related Informa...

Chapter 4 261 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 anumber from one to the configured maximum. Operation Notes A resource identification num...

262 Chapter 4 Command Definition F-K FTN FTN Compiles a compatibility mode FORTRAN 77/V program. FORTRAN 77/V is not part ofthe HP 3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. The native mode equivalent of this command is FTNXL . Syntax FTN [ textfi...

Chapter 4 263 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 anoth...

264 Chapter 4 Command Definition F-K FTNGO FTNGO Compiles, prepares, and executes a compatibility mode HP FORTRAN 77/V program. HPFORTRAN 77/V is not part of the HP 3000 Series 900 Computer System FundamentalOperating Software and must be purchased separately. The native mode equivalent of thiscomma...

Chapter 4 265 Command Definition F-K FTNGO Use This command may be issued from a session, job, or program. It may not be used inBREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples To compile, prepare, and execute an HP FORTRAN 7...

266 Chapter 4 Command Definition F-K FTNPREP FTNPREP Compiles and prepares a compatibility mode HP FORTRAN 77/V program. HP FORTRAN77/V is not part of the HP 3000 Series 900 Computer System Fundamental OperatingSoftware and must be purchased separately. The native mode equivalent of this commandis t...

268 Chapter 4 Command Definition F-K FTNXL FTNXL Compiles an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. This command is recognized only if HP FORTRAN 77/iX is installed on yoursystem....

Chapter 4 269 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. HPFORTRAN 77/iX places a single dollar sign ( $ ) before the info string and places the string before the first line of sour...

Chapter 4 271 Command Definition F-K FTNXLGO FTNXLGO Compiles, links, and executes an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is notpart of the HP 3000 Series 900 Computer System Fundamental Operating Software andmust be purchased separately. This command is recognized only if HP FORTRAN 77/iX is...

Chapter 4 273 Command Definition F-K FTNXLLK FTNXLLK Compiles and links an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part ofthe HP 3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. This command is recognized only if HP FORTRAN 77/iX is installedo...

Chapter 4 275 Command Definition F-K GETLOG GETLOG Establishes a logging identifier on the system. Syntax GETLOG logid ;LOG= logfile { ,DISC ,TAPE ,SDISC ,CTAPE } [ ;PASS= password ] [ { ;AUTO ;NOAUTO } ] Parameters logid The logging identifier to be established. This must contain from one toeight a...

276 Chapter 4 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 lin...

Chapter 4 277 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 containfrom one to eight alphanumeric characters, b...

280 Chapter 4 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 p...

284 Chapter 4 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 det...

Chapter 4 285 Command Definition F-K HELLO home group as your logon group when you log on. But if you want to use some other groupas your logon group, you must specify that group's name in your logon command in thisway: MPE iX:HELLO USER.TECHPUBS,MYGROUP If your user name is not related to a home gr...

Chapter 4 287 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 | FUNCT...

288 Chapter 4 Command Definition F-K HELP 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 specifiedcommand. ALL Displays all parameters, operation information, an...

290 Chapter 4 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 promp...

292 Chapter 4 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. Theoperators listed in Table 4-1 may be incorporated...

Chapter 4 293 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 sim...

294 Chapter 4 Command Definition F-K INPUT INPUT Permits the user to assign a value interactively to any variable that could otherwise be setwith 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 IN...

296 Chapter 4 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 <FILEONE The above example reads the first record in FILEONE ...

298 Chapter 4 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 bya slash ( / ). queuename The name of t...

300 Chapter 4 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 onlywhen listing is directed to a spooled device, and is ...

302 Chapter 4 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.TECHPU...

Chapter 4 303 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, smallernumbers are less limiting...

Chapter 4 305 Command Definition F-K JOBPRI JOBPRI Sets or changes the default execution priority for batch jobs and sets a maximum executionpriority for batch jobs. (Native Mode) Syntax JOBPRI [ maxsubqueue ] [ , defaultsubqueue ] Parameters maxsubqueue The maximum priority at which batch jobs are ...

306 Chapter 4 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 ...

308 Chapter 4 Command Definition F-K JOBSECURITY If the HP Security Monitor is installed with both stream privilege and authorizationturned on, the JOBSECURITY command will display a warning when the output produces a different result. :JOBSECURITY ;PASSEXEMPT=USER Security Monitor is installed. Pas...

Chapter 4 309 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 modecommand is VSRELEASESYS . (Native Mode) Syntax LDISMOUNT [ { * | | volumesetname ...

312 Chapter 4 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 num...

314 Chapter 4 Command Definition F-K LINK LINK Creates an executable program file by merging the relocatable object modules from all thefiles in its FROM= parameter. Those files may correspond to object files, relocatable files, or a combination of them. It also searches any relocatable libraries me...

316 Chapter 4 Command Definition F-K LINK Table 4-4 Checklevel Values entryname The name (label) of the point within a program where execution begins.When you omit this parameter, the loader begins execution from theprimary program entry point (which corresponds to a program's mainprocedure or outer...

318 Chapter 4 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...

Chapter 4 319 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 o...

Chapter 4 321 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. F...

Chapter 4 323 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 specif...

324 Chapter 4 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 th...

Chapter 4 325 Command Definition F-K LISTF 2 Displays the file name, file code, record size, file type, currentend-of-file location, and the maximum number of recordsallowed in the file. It also displays the blocking factor, numberof sectors in use, number of extents currently allocated, and themaxi...

326 Chapter 4 Command Definition F-K LISTF listfile The name of the output file to which the file information will be written. Ifyou omit this parameter, the output appears on $STDLIST. If you specify listfile , the output is sent to a temporary file created for this purpose. The temporary file is a...

Chapter 4 327 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;*PRT...

328 Chapter 4 Command Definition F-K LISTF DISC DEV # 3 ACCESSED FRI, 21 SEP 1986, 12:46 PM CLASS DISC LABEL ADDR ** SEC OFFSET 0 VOLSET MPEXL_SYSTEM_VOLUME_SET or VOLNAME MPEXL_SYSTEM_VOLUME_SET: MEMBER1 or VOLCLASS MPEXL_SYSTEM_VOLUME_SET: DISC CLASS : DISC LABEL ADDR: $00000010 $0010E014 Level 6 ...

Chapter 4 329 Command Definition F-K LISTF ACCESS: R-excl REC#: 336 FNUM: 15 LOCKSOwner Waiter OPEN FLOCK Level -2 File Display FILENAME ACD ENTRIES DOCMNTS NO ACDS Level -3 File Display :LISTF DOCMNTS,-3 ******************** FILE DOCMNTS.DEVELOP.HPXLII FCODE O FOPTIOc NS STD,ASCII,FIXED,NOCCTL 1549...

330 Chapter 4 Command Definition F-K LISTF 00010405 00000000 00000300 00020CEE 0EA78B32 00020CEE .......H........ 0EA78B32 00020CEE 12F61E2D 00020CEE 0EA78B32 00000000 ................ 000000A0 000001F5 00000000 00000000 00000000 00000000 ........... .. 00009C90 00000000 00000000 00000000 00000050 0...

Chapter 5 331 Command Definitions L-O 5 Command Definitions L-O

332 Chapter 5 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...

334 Chapter 5 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 filesthat match fileset are found, and searched recursively to display the files and directories that matc...

Chapter 5 335 Command Definitions L-O LISTFILE 1 SUMMARY Displays the file name, file code, record size, record format, and other filecharacteristics such as ASCII or binary records, carriage-control option,file type, current end-of-file location, and the maximum number of recordsallowed in the file...

338 Chapter 5 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. NOT...

Chapter 5 339 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, directorynames are shown ...

340 Chapter 5 Command Definitions L-O LISTFILE In the next example, specifying the absolute pathname produces a listing of all entries onelevel 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...

Chapter 5 341 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. /ACCT/GROUP/d0:listfile /, qualify;seleq=[object=dir];format=qualify / /ACCT/ /ACCT/GROUP/ /ACCT/GROUP/d0/ /ACCT/...

344 Chapter 5 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 ...

Chapter 5 345 Command Definitions L-O LISTFTEMP SECTORS The number of sectors allocated for the file on disk. This number is alwaysa multiple of 16 (the page size in MPE/iX). This value is an indication ofthe size of the file. #X Number of extents. This number is displayed only to maintaincompatibil...

348 Chapter 5 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) andsystem managers (SM), ...

350 Chapter 5 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 ...

Chapter 5 351 Command Definitions L-O LISTLOG LISTLOG Lists currently active logging identifiers on the system and whether automatic log filechanging has been enabled. Syntax LISTLOG [ logid [ ;PASS] ] Parameters logid The specific logging identifier to be verified. Default is to list all currentlya...

Chapter 5 353 Command Definitions L-O LISTREDO LISTREDO Displays the contents of the command line history stack. You may specify the format inwhich the listing appears, and whether it appears on $STDLIST or in a file. (Native Mode) Syntax LISTREDO [ START= m ] [ ;END= n ] [ ;OUT= outfile ] [ ;{ ABS ...

Chapter 5 355 Command Definitions L-O LISTSPF LISTSPF Produces a listing of input and output spooled files. (Native Mode) Syntax LISTSPF [ [ IDNAME=] { spoolid ( spoolid [ , spoolid ] ...) } ] [ [ ;SELEQ=] { select-eq ^ indirect_file } ] [ ;DETAIL ;STATUS ] NOTE This command follows the optional MPE...

356 Chapter 5 Command Definitions L-O LISTSPF If you are not an SM, OP, AM, or console user, the following commanddisplays all the output files in your default group with a priority greaterthan 2 that were created before September 30, 1994. LISTSPF O@;SELEQ=[(PRI>2)AND(DATE<09/30/94)] Selectio...

Chapter 5 357 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 spoolfiles; therefore, any logical condition involving the attribute always returns FALSE when tested against a...

360 Chapter 5 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 JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER #01 J12345 $STDLIST 6 1 EPOC CRE...

Chapter 5 363 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 andoutput spool files to the right. Of these, only SELECTED is not a state. Instead, SELECTED shows the total co...

Chapter 5 365 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...

366 Chapter 5 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 LISTUS...

Chapter 5 367 Command Definitions L-O LMOUNT LMOUNT Requests a logical reservation of a volume set. This informs the system that the volume setis to be reserved system-wide. The equivalent native mode command is VSRESERVESYS . (Native Mode) Syntax LMOUNT [ { * volumesetname } ] [ . groupname [ . acc...

370 Chapter 5 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 Termina...

Chapter 5 371 Command Definitions L-O =LOGOFF =LOGOFF Aborts all executing jobs/sessions and prevents any further logons. You may optionallyspecify one job or one session that is to remain logged on. Syntax =LOGOFF [ #S nnn ] or =LOGOFF [ #J nnn ] Parameters # S nnn or # J nnn The number of the sess...

372 Chapter 5 Command Definitions L-O =LOGOFF CTRL A =LOGOFF #S1 =LOGON LIMIT 0,0JOBFENCE 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 operatorcontrols #S1 . Related Informatio...

374 Chapter 5 Command Definitions L-O MOUNT MOUNT Sends a request to the system to reserve a volume set (keep it online). The set must beonline in order to have the command take effect. (Native Mode) Syntax MOUNT [ { * volumesetname } ] [ . groupname [ . acctname ] ] [ ;GEN=[ genindex ] ] Parameters...

Chapter 5 377 Command Definitions L-O NEWACCT NEWACCT Creates a new account with an associated account manager and PUB group. Syntax NEWACCT acctname , mgrname [ ;PASS=[ password ] ] [ ;FILES=[ filespace ] ] [ ;CPU=[ cpu ] ] [ ;CON NECT=[ connect ] ] [ ;CAP=[ capabilitylist ] ] [ ;ACCESS=[ fileacces...

378 Chapter 5 Command Definitions L-O NEWACCT cpu Limit on total CPU-time, in seconds, for this account. This limit is checkedonly when a job or session is initiated, and so the limit never causes the jobor session to abort. The maximum value you may define with NEWACCT is 2,147,483,647 seconds. Def...

382 Chapter 5 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 sla...

Chapter 5 383 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 iscase-sensitive. In the second example, the user enters the informati...

384 Chapter 5 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= volume...

Chapter 5 385 Command Definitions L-O NEWGROUP connect The limit on the total cumulative session connect-time, in minutes, thatthe group is allowed. This limit is checked at logon and whenever thesession initiates a new process. The maximum value you may specify withthis command is 2,147,483,647 min...

388 Chapter 5 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, anerror is indicated. limit Maximum number of jobs that can be allowed in this ...

Chapter 5 389 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. linkn...

390 Chapter 5 Command Definitions L-O NEWLINK Table 5-7 CI Commands Affected by Symbolic Links You can issue the NEWLINK command from a session, job, program, or in BREAK. NEWLINK requires Save Files (SF) capability, Create Directory entry (CD) and Traverse Directory(TD) permissions. Command Name Fo...

Chapter 5 391 Command Definitions L-O NEWLINK Examples The following tree structure will be used to construct the examples that follow it. Assumethat the CWD is /ACCT1/PUB. ROOT |- | | | ACCT1 dir SOFTWARE | / \ | - f1 f2 | | | | PUB dir1 PUB CODE | / \ | | - file1 file2 ACCTORG - | | | | | |ACCTUDC...

392 Chapter 5 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...

Chapter 5 393 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 } ] [...

Chapter 5 395 Command Definitions L-O NEWUSER Table 5-8 User Capabilities Use This command may be issued from a session, a job, a program, or in BREAK. Pressing Break has no effect on this command. Account manager (AM) or system manager (SM) capabilityis required to execute this command. Examples To...

Chapter 5 397 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 ] ] } ]...

398 Chapter 5 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 usingthe Remote Process Management (RPM) service. RPML Enables local users to create and kill processes on ...

Chapter 5 399 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 ...

Chapter 5 401 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...

402 Chapter 5 Command Definitions L-O OCTCOMP OCTCOMP Converts a compiled MPE V/E program into native mode (NM) code for the HP 3000 Series900. (Native Mode) CAUTION Before using this command be sure your logon group and account does notcontain files of the form Yn, Ynn or Ynnn where n is any alphan...

Chapter 5 405 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 filewith each succeeding invocation of OCTCOMP . In each example, the input...

406 Chapter 5 Command Definitions L-O OPENQ OPENQ Opens the spool queue(s) for a specified logical device, or device name or all devicemembers of a device class. (Native Mode) Syntax OPENQ { ldev [ ;SHOW] devclass [ ;SHOW] devname [ ;SHOW] @ } Parameters ldev The logical device number of the device....

410 Chapter 5 Command Definitions L-O OUTFENCE OUTFENCE Defines the minimum priority that an output spoolfile needs in order to be printed. (NativeMode) Syntax OUTFENCE outputpriority [ ;LDEV= ldev ] [ ;DEV= { ldev devclass devname } ] Parameter outputpriority A number between 1 and 14, inclusive. A...

Chapter 6 413 Command Definitions P-R 6 Command Definitions P-R

414 Chapter 6 Command Definitions P-R PASCAL PASCAL Compiles a compatibility mode Pascal/V program. Pascal/V is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. The native mode equivalent of this command is PASXL . Syntax PASCAL [ text...

Chapter 6 415 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 ...

416 Chapter 6 Command Definitions P-R PASCALGO PASCALGO Compiles, prepares, and executes a compatibility mode Pascal/V program. Pascal/V is notpart of the HP 3000 Series 900 Computer System Fundamental Operating Software andmust be purchased separately. The native mode equivalent of this command is ...

Chapter 6 417 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 $OLDP...

418 Chapter 6 Command Definitions P-R PASCALPREP PASCALPREP Compiles and prepares a compatibility mode Pascal/V program. Pascal/V is not part of theHP 3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. The native mode equivalent of this command is PASXLLK...

420 Chapter 6 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 (abortsexecution). It cannot be used if $STDIN or $STDLIST are redirected. Operation T...

Chapter 6 421 Command Definitions P-R PASXL PASXL Compiles an HP Pascal/iX program. HP Pascal/iX is not part of the HP 3000 Series 900Computer System Fundamental Operating Software and must be purchased separately.(Native Mode) Syntax PASXL [ textfile ] [ ,[ objectfile ] [ ,[ listfile ] [ , libfile ...

Chapter 6 423 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...

424 Chapter 6 Command Definitions P-R PASXLGO PASXLGO Compiles, links, and executes an HP Pascal/iX program. HP Pascal/iX is not part of the HP3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. (Native Mode) Syntax PASXLGO [ textfile ] [ ,[ listfile ] [ ,...

426 Chapter 6 Command Definitions P-R PASXLLK PASXLLK Compiles and links an HP Pascal/iX program. HP Pascal/iX is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. (Native Mode) Syntax PASXLLK [ textfile ] [ ,[ progfile ] [ ,[ listfile ...

428 Chapter 6 Command Definitions P-R PAUSE PAUSE The PAUSE command allows the current task to be suspended or “sleep” for a specifiecnumber 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 6 431 Command Definitions P-R PAUSE The next example sleeps while the backup job ("JBACKUP,OP.SYS") has not beenstreamed. 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...

432 Chapter 6 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 ...

434 Chapter 6 Command Definitions P-R PREP PREP Prepares a compatibility mode program from a user subprogram library (USL) file onto aprogram file. Syntax PREP uslfile,progfile [;ZERODB][;CAP= capabilitylist ] [;PMAP] [;RL= filename ] [;MAXDATA= segsize ] [;PATCH= patchsize ] [;STACK= stacksize ] [;...

Chapter 6 437 Command Definitions P-R PREPRUN PREPRUN Prepares and executes a compiled compatibility mode program. Syntax PREPRUN uslfile [, entrypoint ] [;NOPRIV] [;PMAP] [;NOCB] [;DEBUG] [;INFO= quotedstring ] [;LMAP[;STDIN [{ *formaldesig = fileref $NULL}]]] [;MAXDATA= segsize ] [;PARM= parameter...

438 Chapter 6 Command Definitions P-R PREPRUN LMAP Request to produce a descriptive listing of the allocated (loaded) programto 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 Requ...

440 Chapter 6 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 s...

Chapter 6 441 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 prepa...

442 Chapter 6 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 ...

Chapter 6 443 Command Definitions P-R PRINT n 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, thatis, -5 indicates the fifth record from the end-of-file. Zero is an invalidspecification. Def...

444 Chapter 6 Command Definitions P-R PRINT NUM Specifies numbering of the lines as they are displayed. The numbersappear in front of the line (record) being displayed. The number displayedis the actual line number for numbered files; for unnumbered files, relativenumbering begins with 1. NONUM Requ...

446 Chapter 6 Command Definitions P-R PRINT NOTE The above file was considered by PRINT to be a numbered file and thus thetrailing 8 bytes are truncated PRINT UFILEYES;NONUM aaaaaaaaaaaa00010001 bbbbbbbbbbbb00010002 cccccccccccc00010003 dddddddddddd00010004 eeeeeeeeeeee00020001 ffffffffffff00020002 ...

Chapter 6 447 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 ;NOSHOW...

450 Chapter 6 Command Definitions P-R PURGEACCT PURGEACCT Removes an account and its groups and users from the system directory or from thespecified volume set's directory. Syntax PURGEACCT acctname [ ;ONVS= volumesetname ] Parameters acctname Name of the account to be deleted. This name must contai...

452 Chapter 6 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 director...

Chapter 6 457 Command Definitions P-R PURGEGROUP PURGEGROUP Removes a group (and all files belonging to it) from the system or from the specifiedvolume set directory. Syntax PURGEGROUP groupname [ . acctname ] [ ;ONVS= volumesetname ] Parameters groupname Name of the group in the logon account to be...

Chapter 6 459 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 ex...

460 Chapter 6 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 specificationapply to this parameter. This is a required parameter. You may not use wildcards...

Chapter 6 461 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 thelogon account of the account manager. Op...

Chapter 6 463 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...

Chapter 6 465 Command Definitions P-R REDO REDO Allows the user to edit and reexecute any command still retained in the command linehistory stack. (Native Mode) Syntax REDO [ [ CMD=] cmdid ] [ [ ;EDIT=] editstring ] NOTE This command follows the optional MPE/iX command line syntax. Refer to"Opti...

466 Chapter 6 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 editst...

468 Chapter 6 Command Definitions P-R REDO Editing Samples The Table 6-4 shows examples of using the REDO command. >^ 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 foll...

Chapter 6 471 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 log...

472 Chapter 6 Command Definitions P-R RELEASE RELEASE Removes security provisions from a file. Security does not resume for a released file untilyou enter the SECURE command for the file. Syntax RELEASE filereference Parameters filereference Specifies the actual file designator of the file whose fil...

474 Chapter 6 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 t...

Chapter 6 475 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 ...

476 Chapter 6 Command Definitions P-R RENAME Files in HFS directories can be renamed to files in the MPE account groupstructure, 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 ...

Chapter 6 477 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 ofthe message requesting the REPLY , the PIN always appea...

Chapter 6 479 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 Spe...

Chapter 6 481 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 alsodisplayed, but their file space counts are displayed as zero even though they ma...

482 Chapter 6 Command Definitions P-R RESET RESET Cancels file equations. Syntax RESET { formaldesignator @ } Parameters formal-designator 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 en...

484 Chapter 6 Command Definitions P-R RESETACCT RESETACCT Resets the running counts of CPU-time or connect-time accumulated by an account and byall groups within that account to zero. Syntax RESETACCT [ { @ acct } [ ,{ CPU CONNECT } ] ] Parameters @ Specifies that the counters for all accounts, and ...

Chapter 6 485 Command Definitions P-R RESETDUMP RESETDUMP Disarms the debug facility call that is made during abnormal process termination. (NativeMode) Syntax RESETDUMP Parameters None Operation Notes This command disarms the debug facility (armed by using the SETDUMP command) after a process abort...

486 Chapter 6 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 AC...

Chapter 6 489 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 temporaryfiles). n@x Restore all files starting with the character n and ending with t...

490 Chapter 6 Command Definitions P-R RESTORE Database corruption may result if not all database files are restored from abackup. Be sure that you only want to restore certain database files beforeoverriding the default behavior with ;PARTIALDB . MPE and HFS Naming Equivalences When an MPE name comp...

Chapter 6 491 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. SHOW Request to list names of restored files. Default is a listing of the totalnumber of all file...

494 Chapter 6 Command Definitions P-R RESTORE filegroupname The file sharing group name which will be the new gid for all files beingrestored. If this parameter is not specified then the gid on the media ispreserved. KEEP If a file on the RESTORE media has the same name as a file alreadyresiding on ...

496 Chapter 6 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 volumeset. Volume Set Notes VOLSET , VOLCLASS and VOL may not be used with the DEV option. You can inadvertent...

Chapter 6 497 Command Definitions P-R RESTORE Database corruption may result if not all database files are restored from abackup. Be sure that you only want to restore certain database files beforeoverriding the default behavior with ;PARTIALDB . THE FOLLOWING OPTIONS ARE AVAILABLE ONLY IF TURBOSTOR...

498 Chapter 6 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 res...

500 Chapter 6 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 ; NUM...

Chapter 6 503 Command Definitions P-R RESUMEJOB RESUMEJOB Resumes a suspended job. (Native Mode) Syntax RESUMEJOB #J nnn Parameters #J nnn 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 ex...

504 Chapter 6 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 n...

Chapter 6 505 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 spool...

506 Chapter 6 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 unne...

Chapter 6 507 Command Definitions P-R RETURN RETURN Causes execution to return from the current user command (UDC or command file) to thecalling environment. (Native Mode) Syntax RETURN Parameters None Operation Notes This command terminates the execution of the currently executing user command. Con...

508 Chapter 6 Command Definitions P-R RPG RPG Compiles an RPG/V program in compatibility mode. RPG/V is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. Syntax RPG [ textfile ] [ ,[ uslfile ] [ ,[ listfile ] [ ,[ masterfile ] [ ,[ newf...

510 Chapter 6 Command Definitions P-R RPGGO RPGGO Compiles, prepares, and executes an RPG/V program in compatibility mode. RPG/V is notpart of the HP 3000 Series 900 Computer System Fundamental Operating Software andmust be purchased separately. Syntax RPGGO [ textfile ] [ ,[ listfile ] [ ,[ masterf...

512 Chapter 6 Command Definitions P-R RPGPREP RPGPREP Compiles and prepares an RPG/V program in compatibility mode. RPG/V is not part of theHP 3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. Syntax RPGPREP [ textfile ] [ ,[ progfile ] [ ,[ listfile ] [...

Chapter 6 515 Command Definitions P-R RPGXL RPGXL Compiles an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 ComputerSystem Fundamental Operating Software and must be purchased separately. Thiscommand is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXL ...

Chapter 6 517 Command Definitions P-R RPGXL RPGXL MAIN, OBJMAINFTNXL 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=NMRLRPGXL MAIN, RLFILEFTNXL SUB, RLFILEL...

518 Chapter 6 Command Definitions P-R RPGXLGO RPGXLGO Compiles, links, and executes an RPG/XL program. RPG/XL is not part of the HP 3000Series 900 Computer System Fundamental Operating Software and must be purchasedseparately. This command is recognized only if RPG/XL is installed on your system.(Na...

Chapter 6 519 Command Definitions P-R RPGXLGO Use This command may be issued from a session, job, or program. It may not be used inBREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Example To compile, link, and execute an RPG/XL progra...

520 Chapter 6 Command Definitions P-R RPGXLLK RPGXLLK Compiles and links an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900Computer System Fundamental Operating Software and must be purchased separately.This command is recognized only if RPG/XL is installed on your system. (Native Mode)...

Chapter 6 521 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 b...

522 Chapter 6 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 willoverride the default parameters that the creator of the program established, but only forthat particular ex...

Chapter 6 525 Command Definitions P-R RUN Stub This symbol marks an import (outbound). The Link Editor creates animport stub for the unsatisfied code symbols, and the Loader satisfies thereference by filling in the XRT entry allocated for this stub. Plabl This symbol defines an export stub for a pro...

526 Chapter 6 Command Definitions P-R RUN A DXRT entry is indexed negatively from the DP of the SOM. The DXRT column gives thisoffset, which is in bytes. The value is in hexadecimal format. The DXRT Addr column givesthe indirect address for the import symbol. The last column gives the access rights ...

Chapter 6 527 Command Definitions P-R RUN Continuing with the PDD area, the remaining columns starting with Type through R/Ware 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 o...

Chapter 6 529 Command Definitions P-R RUN The default is -1, which currently instructs MPE/iX to assign asystem-defined constant as the value of nmstacksize . nmheapsize The maximum size, in bytes, to which the NM heap may grow. This mustbe a decimal number. If a value is specified which is less tha...

Chapter 6 531 Command Definitions P-R RUN appear as can t'', " and " must appear as ""and"" , 'but ' must appear as but''''. The maximum length of the string, including delimiters, is 255characters. Refer to "Examples." If the executing program is a compatibility mode...

Chapter 7 535 Command Definitions S-SO 7 Command Definitions S-SO

536 Chapter 7 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 bereferenced by the name $OLDPASS . newfile-...

540 Chapter 7 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 listedoutput from the MPE segmenter. Formal file designator is SEGLIST . Default is $STDLIST . Usua...

542 Chapter 7 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}][ ...

Chapter 7 543 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.SYS;PARM=1;MAXDATA=16000 !IF JCW < FATAL THEN !SET STDLIST=DELETE !ENDIF !EOJ Related Information Commands ...

544 Chapter 7 Command Definitions S-SO SETCATALOG SETCATALOG Catalogs, or enables, the user-defined commands (UDCs) in a specified catalog file at theuser, account, or system level. You can also use this command to disable all UDCs on thesystem. (Native Mode) WARNING If you do not specify a catfilen...

Chapter 7 547 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 f...

548 Chapter 7 Command Definitions S-SO SETCLOCK NOW This option is meaningful only when the date and time specifications areprovided. NOW forces the change to be immediate. See the warning in the Operation Notes section about the dangers of changing the system timeimmediately. CANCEL Cancels a curre...

Chapter 7 549 Command Definitions S-SO SETCLOCK On the HP3000 Universal Time (GMT) is calculated by starting with local time and addingor subtracting a time zone offset. When changing time zones (such as moving fromStandard to Daylight Savings Time and back) the local time is altered, but this chang...

550 Chapter 7 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 toresume its normal pace. Any previous correction will remain. When this option is used, thes...

Chapter 7 551 Command Definitions S-SO SETCLOCK This list is only meant to include a few of the dangers associated with an immediate timechange; 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 fullkno...

552 Chapter 7 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 00minutes in the Western Hemisphere (Pacific Standard Time) to 7 hours 00 minutes in...

Chapter 7 553 Command Definitions S-SO SETCOUNTER SETCOUNTER Sets the next value of a specified resource counter, and optionally enables automaticrollback when a specified limit is reached. Duplicate values are avoided. Syntax SETCOUNTER[ COUNTER=] [ INSP | OUTSP | JOBNUM | SESSNUM ] [ ;BASE = num ]...

556 Chapter 7 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. ...

558 Chapter 7 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 controlword (JCW). You can use @ to specif...

Chapter 7 559 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 ...

Chapter 7 561 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...

Chapter 7 563 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 o...

564 Chapter 7 Command Definitions S-SO SETVAR SETVAR Assigns values to MPE/iX variables. (Native Mode) Syntax SETVAR varname { <space> , ; } expression Parameters varname The variable that is to be set to a value. expression The expression that is evaluated and assigned to varname . Operation ...

566 Chapter 7 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 i...

568 Chapter 7 Command Definitions S-SO SHOWALLOCATE SPOOK5.PUB.SYS . . . . . . . . 1 SLPATCH.PUB.SYS . . . . . . . . 0 NUMBER OF PROGRAMS FOUND = 2 To display summary status information regarding allocation. SHOWALLOCATE STATUS ALLOCATION STATUS NUMBER OF PROGRAMS ALLOCATED = 3 ALLOCATION RELATED TA...

Chapter 7 569 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...

570 Chapter 7 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...

Chapter 7 571 Command Definitions S-SO SHOWCATALOG Examples To display the account-level UDC files of all users in the GRIMSBY account, enter: SHOWCATALOG ;[email protected] To display the system-level UDC files of all users in all accounts, enter: SHOWCATALOG ;USER=@.@ To display all UDC command files...

572 Chapter 7 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 thecommand SETCLOCK for information about time correc...

Chapter 7 573 Command Definitions S-SO SHOWDEV SHOWDEV Reports the status of input/output devices. Syntax SHOWDEV [ ldev classname ] [ ;ACD] Parameters ldev Logical device number of device for which status information is to bedisplayed. This number is unique for each device. Default is that statusin...

Chapter 7 575 Command Definitions S-SO SHOWDEV 1600 Density of 1600 BPI, or the density of the tape isunrecognizable. ASSOCIATION Indicates the logical devices by device class that have been established bythe user with the ASSOCIATE command. ACD Access Control Definition. May include any of the foll...

576 Chapter 7 Command Definitions S-SO SHOWIN SHOWIN Reports the status of input device files. Syntax SHOWIN [ #I nnn STATUS ] [ ;SP] [ ; item [ ; item [ ;...] ] ] Parameters #I nnn Identifies the particular input device file for which information is to bedisplayed. Default is that MPE/iX displays i...

578 Chapter 7 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 issu...

Chapter 7 579 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 alluser-defined and system-defined JCWs are displayed....

582 Chapter 7 Command Definitions S-SO SHOWJOB Parameters for Item JOB= A list of jobs/sessions for which status information is to be displayed. Useone of the following options: @J Displays status information for all jobs. @S Displays status information for all sessions. @ Displays status informatio...

Chapter 7 583 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 ...

Chapter 7 585 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 form...

586 Chapter 7 Command Definitions S-SO SHOWLOGSTATUS SHOWLOGSTATUS Displays status information about currently opened user logging files assigned to a loggingidentifier. Syntax SHOWLOGSTATUS [ logid ] Parameters logid Displays status of the user logging file associated with the loggingidentifier, lo...

Chapter 7 587 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." Related Information Commands ALTLOG , CHA...

588 Chapter 7 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 U...

592 Chapter 7 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 LDEVnumber of the device. JOBNUM The job/session number ( jsnum ) of job or session using the device fil...

596 Chapter 7 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 SHOWP...

598 Chapter 7 Command Definitions S-SO SHOWPROC :SHOWPROC pin=(2,99,121,188);format=detail;system PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP - - - 2 1 142 L 7:23.687 WAIT (LOAD.PUB.SYS) LOGON : PROGRAM : LOAD.PUB.SYS QUEUE : BS WORKGROUP : BS_Default *********************** PIN PARENT PRI CP...

Chapter 7 599 Command Definitions S-SO SHOWPROC C152 0:02.000 WAIT S12 38 (TDP.PUB.SYS) text myfile C152 0:01.030 READY S12 67 (FCOPY.PUB.SYS)from=foo.pub.sys;to=ba r;new Example To display a summary of information for all non-system processes in the currentjob/session, enter: :SHOWPROC To display a...

600 Chapter 7 Command Definitions S-SO SHOWQ SHOWQ Displays scheduling data for all processes and the scheduling characteristics of the CS, DSand ES scheduling subqueue(s). (Native Mode) SYNTAX SHOWQ [ ;ACTIVE] [ ;STATUS] Parameters ACTIVE Displays only the processes currently running or those about...

Chapter 7 603 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 h...

604 Chapter 7 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. jobi...

Chapter 7 605 Command Definitions S-SO SHOWVAR Table 7-2 Specified Variable-ID/Result 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( _ ). Used ...

606 Chapter 7 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 usera...

608 Chapter 7 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 ...

Chapter 7 609 Command Definitions S-SO SHUTQ SHUTQ Closes the spool queue(s) for the specified logical device, device name, or all members of adevice class. (Native Mode) Syntax SHUTQ { ldev [ ;SHOW] devclass [ ;SHOW] devname [ ;SHOW] @ } Parameters ldev The logical device number of the device. devc...

610 Chapter 7 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 thespecified device, enter: SHUTQ 6;SHOW Related Information Commands OPENQ , STARTSPOOL , SPOOLER...

Chapter 8 611 Command Definitions SP-Z 8 Command Definitions SP-Z

612 Chapter 8 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 outputspeeds must always be equal. Accepta...

Chapter 8 613 Command Definitions SP-Z SPEED Use This command may be issued from a session, program, or in BREAK. This command is notavailable from a job. Pressing Break has no effect on this command. Examples To manually change the speed and enter MPE (the { is a random character), enter: CHANGE SP...

614 Chapter 8 Command Definitions SP-Z SPL SPL Compiles a compatibility mode SPL/V program. SPL/V is not part of the HP 3000 Series900 Computer System Fundamental Operating Software and must be purchasedseparately. Syntax SPL [ textfile ] [ ,[ uslfile ] [ ,[ listfile ] [ ,[ masterfile ] [ , newfile ...

Chapter 8 615 Command Definitions SP-Z SPL newfile 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. NOTE The formal file designators used in this command ( SPLTEXT , SP...

Chapter 8 617 Command Definitions SP-Z SPLGO SPLGO Compiles, prepares, and executes a compatibility mode SPL/V program. SPL/V is not partof the HP 3000 Series 900 Computer System Fundamental Operating Software and mustbe purchased separately. Syntax SPLGO [ textfile ] [ , [ listfile ] [ , [ masterfi...

Chapter 8 619 Command Definitions SP-Z SPLPREP SPLPREP Compiles and prepares a compatibility mode SPL/V program. SPL/V is not part of the HP3000 Series 900 Computer System Fundamental Operating Software and must bepurchased separately. Syntax SPLPREP [ textfile ] [ , [ progfile ] [ , [ listfile ] [ ...

622 Chapter 8 Command Definitions SP-Z SPOOLER SPOOLER Controls spooler processes. (Native Mode) Syntax SPOOLER[ DEV=] { ldev | devclass | devname } { ;SHOW } { ;OPENQ [;SHOW]} { ;SHUTQ [ ;SHOW]} { ;START [ ;OPENQ | ;SHUTQ] [ ;SHOW]} { ;STOP [ ;FINISH | ;NOW] [ ;OPENQ | ;SHUTQ] [ ;SHOW]} { ;SUSPEND[...

Chapter 8 627 Command Definitions SP-Z SPOOLER prints the file starts the first copy with the page following the pagenumber saved in the FLABX and the file's header and trailer (if any)include (RESUMED) if printing starts anywhere but at the first page. [+/-] page The page parameter may be used only...

Chapter 8 629 Command Definitions SP-Z SPOOLER Spooler processes come in two varieties: input spoolers and output spoolers. • An input spooler reads data from its device and uses that to create an input spool file. The data may consist of one or more batch jobs, data files, or any combination of the...

Chapter 8 631 Command Definitions SP-Z SPOOLF SPOOLF Allows a qualified user to alter, print, or delete output spool file(s). (Native Mode) Syntax SPOOLF { [ [ IDNAME=] { spoolid ( spoolid [ , spoolid ] . . .) } [ ;DEV= { ldev devclass devname } ] [ ;PRI= outpri ] [ ;COPIES= numcopies ] [ ;SELEQ= { ...

638 Chapter 8 Command Definitions SP-Z SPOOLF Use This command may be issued from a session, job, or program, or in BREAK. SPOOLF ...;SHOW is breakable. However, you cannot stop the actions by pressing BREAK . The files you can access with the SPOOLF command depend on your capabilities. Example Rela...

Chapter 8 639 Command Definitions SP-Z STARTSESS STARTSESS Creates a session on the specified device, if the user has programmatic sessions (PS)capability. Syntax STARTSESS ldev [ sessionname ,] user [ / userpass ] . acct [/ acctpass ][ , group [/ grouppass ]] [ ;TERM={ termtype }][ [;TIME= cpusecs ...

Chapter 8 641 Command Definitions SP-Z STARTSESS termtype Determines terminal-type characteristics. The value of the termtypeparameter determines the type of terminal used for input. MPE/iX usesthis parameter to determine device-dependent characteristics such asdelay factors for carriage returns. Th...

642 Chapter 8 Command Definitions SP-Z STARTSESS The HIPRI option is used for two different purposes when logging on. It can be used to override the system jobfence, or it can be used to overridethe session limit: • When using the HIPRI option to override the jobfence, the system first checks to see...

Chapter 8 643 Command Definitions SP-Z STARTSESS ciparm The command interpreter parameter number you wish to use. If you areusing the MPE/iX command interpreter, the numbers accepted are: 0, 2, 4 Logon UDCs are executed and the CI banner and theWELCOME message are displayed. Default. 1, 3, 5 Same as...

644 Chapter 8 Command Definitions SP-Z STARTSESS Example To start a session named CH5 , with the username ERNST , accountname UDET , groupname JASTA11 , and grouppass PASS on LDEV 21, enter: STARTSESS 21;CH5,ERNST.UDET,JASTA11/PASS Related Information Commands TUNE Manuals Process Management Program...

Chapter 8 645 Command Definitions SP-Z STARTSPOOL STARTSPOOL Initiates the spooler process for a device. Syntax STARTSPOOL [ { ldev [ ;SHUTQ] devclass } ] Parameters ldev The logical device number of a spooled device. When the spooler gainscontrol of the specified device, it controls spooling to it ...

Chapter 8 647 Command Definitions SP-Z STOPSPOOL STOPSPOOL Terminates spooling to a specified device or device class. Syntax STOPSPOOL [ { ldev [ ;OPENQ] devclass } ] Parameters ldev The logical device number of a spooled device. The spooler process gives upownership of the spooled device. If the OP...

648 Chapter 8 Command Definitions SP-Z STOPSPOOL STOPSPOOL LP To terminate spooling on device 6 and leave the queue open, enter: STOPSPOOL 6;OPENQ Related Information Commands STARTSPOOL Manuals STORE and TurboSTORE/iX Manual Volume Management Reference Manual

Chapter 8 651 Command Definitions SP-Z STORE filename/lockword.group.account The HFS syntax is as follows: /dir_lev_1/dir_lev_2/.../dir_lev_i/.../filedesig or ./dir_lev_i/dir_lev_j/.../dir_lev_k/.../filedesig If the name begins with a dot (.), then it is fully qualified by replacing thedot with the ...

Chapter 8 653 Command Definitions SP-Z STORE file.group.acct/ACCT/GROUP/FILE ' One particular file in one particular group in oneparticular account. file.group/LOGON-ACCT/GROUP/FILE One particular file in one particular group in the logonaccount. file./FILE One particular file in the logon group and...

656 Chapter 8 Command Definitions SP-Z STORE SECURITY For MPE format listings, causes SHOW to display the creator and the file access matrix for all the files which donot have an active ACD. For files with active ACDs only,the phrase *ACD EXISTS* is displayed. For HFS format listing, the phrase *ACD...

Chapter 8 657 Command Definitions SP-Z STORE This option cannot be used for files that are attached to a log set. PURGE Instructs STORE to purge all the files that were successfully stored, after the Store operation has ended. In an interactive session, MPE/iX promptsthe user to enter any lockwords ...

658 Chapter 8 Command Definitions SP-Z STORE MPEXL (optional) If MPEXL is specified, then STORE writes out MPE XL compatible media. If the TRANSPORT parameter is used and MPEXL is not specified, then MPE V compatible media is produced. This option is used to facilitatetransport of files with a later...

660 Chapter 8 Command Definitions SP-Z STORE STOREDIREC TORY Specifies that STORE should create a disc file that contains the backupmedia label and directory information. This file will be placed in thestore_dirs directory of the HPSTORE.SYS group ( /SYS/HPSTORE/store_dirs/ ). If this path does not ...

Chapter 8 661 Command Definitions SP-Z STORE STORESET Specifies parallel and sequential backup devices. This option cannot beused if the storefile parameter is specified, and it cannot be used in conjunction with the TRANSPORT option. Sequential tapes are specified in this way ;STORESET = (* tape1 ,...

Chapter 8 663 Command Definitions SP-Z STORE ONLINE Online backup. The store fileset is attached to a log handler and the userscan concurrently read, write or purge files in the fileset after the files areattached to the log environment. The files must not be open for writebefore STORE is invoked, b...

666 Chapter 8 Command Definitions SP-Z STORE Note that the console operator receives a request to mount the tape identified as the user'suser name. To store files from a group and account and to purge them after the STORE , enter :FILE T;DEV=TAPE:STORE @.GROUP.ACCOUNT;*T;PURGE Related Information Co...

668 Chapter 8 Command Definitions SP-Z STREAM WED[NESDAY]THU[RSDAY]FRI[DAY]SAT[URDAY] day-of-month Day-of-month. The integers 1 through 31. It indicates the calendar day ofthe month. If day-of-month is greater than or equal to the currentday-of-month, the current month is indicated. If day-of-month ...

Chapter 8 669 Command Definitions SP-Z STREAM use for this input. As a result, the listing device that corresponds to the streaming device(not necessarily your terminal) displays the job number assigned by MPE/iX and thelisting generated by the job. When you enter STREAM without an input file (that ...

670 Chapter 8 Command Definitions SP-Z STREAM Pressing Break aborts the execution of this command and any job currently being entered through the command. Incompletely spooled disk space is returned to the system. If you make an error while entering the MPE/iX JOB command, you receive an error messa...

Chapter 8 673 Command Definitions SP-Z STREAMS STREAMS Enables or disables the STREAMS device. Allows or disallows users to submit job/datastreams. Syntax STREAMS { ldev OFF } Parameters ldev The logical device number of the STREAMS device. This device must alsohave an output device number or class ...

Chapter 8 675 Command Definitions SP-Z SUSPENDSPOOL SUSPENDSPOOL Suspends output to a spooled device. Syntax SUSPENDSPOOL ldev [ ;FINISH] Parameters ldev The logical device number of a spooled device. FINISH Directs the device to complete the currently active spool file and then stop. Operation Note...

Chapter 8 677 Command Definitions SP-Z SWITCHLOG SWITCHLOG Closes the current system log file, then creates and opens a new one. (Native Mode) Syntax SWITCHLOG Parameters None. Operation Notes When the SWITCHLOG command is executed, MPE/iX displays the previous system log file number ( xxx ), the pe...

Chapter 8 679 Command Definitions SP-Z SYSGEN SYSGEN Starts configuration dialog and/or installation tape creation. The equivalent compatibilitymode command is SYSDUMP . (Native Mode) Syntax SYSGEN [ basegroup ] [ , newgroup ] [ , inputfile ] [ , outputfile ] Parameters basegroup The name of a base ...

Chapter 8 681 Command Definitions SP-Z TELL TELL Sends a message to another session. Syntax TELL { [ #] S nnn [ sessionname ,] username.acctname @ @. acctname @S } [ [ ;] text ] Parameters [#]S nnn The session number as assigned by MPE/iX. This session number receivesthe TELL message. [ sessionname ...

682 Chapter 8 Command Definitions SP-Z TELL TARGET MUST BE INTERACTIVE, NO MESSAGE SENT. (CIWARN 1627). Use This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. Examples To send a message to a user identified as BROWN , logged on under a...

684 Chapter 8 Command Definitions SP-Z TUNE TUNE Changes scheduling characteristics of the scheduling subqueues. These characteristicsinclude base and limit priorities, quantum bounds (min and max), boost property andtimeslice. (Native Mode) Syntax TUNE [ minclockcycle ] { ;CQ= qinfo ;DQ= qinfo ;EQ=...

Chapter 8 685 Command Definitions SP-Z TUNE OSCILLATE Sets the subqueue to oscillate behavior. If set, a process returns to the base priority once its priority has decayed to the limit of the subqueue, even if it has not completed a Dispatcher transaction. tslice The number of milliseconds a process...

686 Chapter 8 Command Definitions SP-Z TUNE max: 2000 max: 2000 max: 2000 boost: DECAY boost: DECAY boost: DECAY tslice: 200 tslice: 200 tslice: 200 NOTE The MPE/iX Scheduler now supports the workgroup concept. However,backward compatibility is maintained through five default workgroupscreated by th...

Chapter 8 687 Command Definitions SP-Z UP UP Returns a particular device to its normal function on the system; cancels any DOWN command issued for the device. This command does not apply to disk drives. Syntax UP ldev Parameters ldev The logical device number of the device being returned to service ...

688 Chapter 8 Command Definitions SP-Z VMOUNT VMOUNT Enables or disables the MPE/iX movable volume facility. (Native Mode) Syntax VMOUNT { ON [ ,AUTO] OFF } [ ;ALL,] Parameters ON or ON,AUTO Enables the movable volume facility so that all valid user MOUNT/VSRESERVE and operator LMOUNT/VSRESERVESYS r...

690 Chapter 8 Command Definitions SP-Z VSCLOSE VSCLOSE Informs the system to close the specified volume set and take it offline. (Native Mode) Syntax VSCLOSE volumesetname [ [ ;PARTVS=] { USER BACKUP } ] [ ;NOW ;SPLIT ] Parameters volume- setname The volume set that is to be closed. Any user who is ...

692 Chapter 8 Command Definitions SP-Z VSCLOSE Examples To close the volume set ACCOUNTING_PAYROLL , enter: VSCLOSE ACCOUNTING_PAYROLL However, if a VSRESERVESYS command has been issued for ACCOUNTING_PAYROLL , then a message is displayed on the console. In order to close this volume set and take it...

Chapter 8 693 Command Definitions SP-Z VSOPEN VSOPEN Reopens a volume set that has been closed with VSCLOSE . The volume set becomes available for use again. (Native Mode) Syntax >VSOPEN volumesetname [ [ ;PARTVS=] { USER BACKUP } ] Parameters volume- setname The volume set to be opened. You must...

694 Chapter 8 Command Definitions SP-Z VSOPEN Vcommand A.B.C Entering Vcommand A fails to access the volume set. You cannot specify the first part of the volume set name alone and expect the group and account to default. Use This command may be issued from a session, job, program, or in BREAK. Press...

Chapter 8 695 Command Definitions SP-Z VSRELEASE VSRELEASE Releases a volume set that was explicitly reserved by the user with VSRESERVE . The equivalent compatibility mode command is DISMOUNT . (Native Mode) Syntax VSRELEASE [ volumesetname ] Parameters volume- setname The volume set to be released...

696 Chapter 8 Command Definitions SP-Z VSRELEASE Example To request that volume set ACCOUNTING_PAYROLL be released, enter: VSRELEASE ACCOUNTING_PAYROLL Related Information Commands The VSxxxxxx commands in this chapter, DISMOUNT Manuals Volume Management Reference Manual

Chapter 8 697 Command Definitions SP-Z VSRELEASESYS VSRELEASESYS Releases a specified volume set previously reserved with the VSRESERVESYS command. The equivalent compatibility mode command is LDISMOUNT . (Native Mode) Syntax VSRELEASESYS volumesetname Parameters volume- setname The name of the MPE/...

698 Chapter 8 Command Definitions SP-Z VSRESERVE VSRESERVE Notifies the system to keep a particular volume set online. The equivalent compatibilitymode command is MOUNT . (Native Mode) Syntax >VSRESERVE [ volumesetname ] [ ;GEN= genindex ] Parameters volume- setname The name of the MPE/iX volume ...

Chapter 8 701 Command Definitions SP-Z VSTORE VSTORE Verifies that the data on a backup media are valid (for example, there are no media errors),and reports any errors incurred by STORE when creating the backup. Syntax VSTORE [ vstorefile ] [ ; filesetlist ] [ ; option [ ;... ] ] where option is: [ ...

Chapter 8 703 Command Definitions SP-Z VSTORE filestovstorefilestoexclude Both filestovstore and filestoexclude may be entered in MPE or HFS syntax. Wildcards are permitted for both MPE and HFS syntax. The MPE syntax is as follows: filename [. groupname [. accountname ] A lockword may be specified f...

708 Chapter 8 Command Definitions SP-Z VSTORE Consecutive tapes are specified in the following way: < user ;RESTORESET = (* tape1 ,* tape2 ,* ta pe3 ,...) This instructs MPE/iX to use only one drive at a time for the vstoreoperation. When the first reel of tape is exhausted, VSTORE will shift to ...

710 Chapter 8 Command Definitions SP-Z VSUSER VSUSER Displays all users of a currently reserved, mountable volume set. (Native Mode) Syntax VSUSER [ volumesetname ] Parameter volume- setname A fully qualified volume set name. Default is that information for all currently reserved volume sets is disp...

712 Chapter 8 Command Definitions SP-Z WARN Example To send a WARN message to all sessions, followed by a WARN message to session #S51 , enter: WARN @;THE SYSTEM WILL SHUTDOWN IN 5 MINUTES. PLS LOG OFF.WARN #S51;LAST CHANCE TO LOG OFF GRACEFULLY. Related Information Commands TELL , TELLOP Manuals Pe...

Chapter 8 713 Command Definitions SP-Z WELCOME WELCOME Defines the welcome message. Syntax WELCOME [ welcfile ] Parameters welcfile An ASCII file containing the welcome message. Operation Notes The operator uses the WELCOME command to compose the message that is transmitted to users when they initia...

Chapter 8 715 Command Definitions SP-Z WHILE WHILE Used to control the execution sequence of a job, session, UDC, or command file. (NativeMode) Syntax WHILE expression [ DO] Parameters expression Logical expression, consisting of operands and relational operators. Table8-1 lists the operators that m...

716 Chapter 8 Command Definitions SP-Z WHILE Nesting of IF and WHILE blocks is limited to a combined total of 30 levels. Each IF or WHILE block read by the Command Interpreter increments the nesting count by 1. NOTE You may not write a WHILE construct in such a way that it physically crossesfrom one...

Appendix A 719 Predefined Variables in MPE/iX A Predefined Variables in MPE/iX Many variables have been predefined for use by the command interpreter. They may beused anywhere you would use your own variables. Table A-1 lists all valid predefinedvariables. Table A-1 Predefined Variables Variable Typ...

720 Appendix A Predefined Variables in MPE/iX HPCPUMSECS R I from root CI = current session CPU-time inmilliseconds; from other CI or process =current process CPU-time in milliseconds zero HPCPUSECS R I from root CI = current session CPU-time inseconds; from other CI or process = currentprocess CPU-...

Appendix B 725 Expression Evaluator Functions B Expression Evaluator Functions The expression evaluator is a system procedure used by the user interface to accept astring, number, or Boolean expression, evaluate it, and return the result. This procedure isused by the CALC , SETVAR , IF , ELSEIF , an...

Appendix B 727 Expression Evaluator Functions BASENAME ( string ) returns thefilenamecomponent CALC basename(‘a.b.c’)CALC basename(‘/a/b/c’)CALC basename(’./a/b’)CALC basename(“./a.sl”,”.sl”)CALC basename (‘/’)CALC basename(“*feq”)CALC basename(‘$null’)CALC basename(‘abc.g’,’c’)CALC basename(/usr/li...

Appendix B 733 Expression Evaluator Functions References References The following references apply to the numbers that appear in parentheses in table B-1. 1. Special rules apply when you use the comparison operators with strings. The strings are compared, character by character, until an inequality ...

734 Appendix B Expression Evaluator Functions References 6. The FINFO function returns a string, Boolean, or an integer value. The result depends upon the option specified. The first parameter, filename , is a string, the name of the file for which you want the information. This must be a fully or p...

Appendix B 739 Expression Evaluator Functions Expression Evaluator Features Expression Evaluator Features The two main types of expressions, which can be processed by the expression evaluator, arenumeric and string. In addition, Boolean expressions may be constructed using numericand string expressi...

Appendix B 741 Expression Evaluator Functions Expression Evaluator Features a+b*c/dcalc !exp 2, $2, %2 setvar exp2 exp+'*e' calc !exp2 6,$6,%6 setvar a hptimef showvar a A = 8:26 AM ** the time when var was set ** calc a + 'in the morning!!! ' 8:26 AM in the morning!!!' calc 'a' + 'in the morning!!!...

Appendix B 743 Expression Evaluator Functions Expression Evaluator Features If a string is expected and a valid quoted string is not found, variable management iscalled to determine if the token is a variable. If it is not a variable, an error is returned. Ifit is a variable containing a string valu...

744 Appendix B Expression Evaluator Functions Expression Evaluator Features ABX SETVAR Z “foo‘CALC “AB‘ + Z ABfoo CALC “AB‘ + “!Z‘ ABfoo CALC “AB‘ + !Z error variable foo not found SETVAR A “X‘+“Y‘CALC A +“B‘ XYB CALC “!HPTIMEF‘ 8:26 AM CALC HPTIMEF 8:26 AM CALC !HPTIMEF error The error in the last ...

Appendix B 745 Expression Evaluator Functions Expression Evaluator Features CALC !A + 2 works. !A is really !B . That in turn yields a value of 2 . The result is 2 + 2 , which equals 4 . CALC “HPTIMEF‘ HPTIMEF But, CALC !HPTIMEF CALC 8:26 AM which produces an error. On the other hand, CALC “!HPTIMEF...

Appendix C 747 Terminal and Printer Types C Terminal and Printer Types The terminal types supported on the advanced terminal processor (ATP) andasynchronous data communications controller (ADCC) terminal/printer controllers forMPE V/E T-MIT or later (MPE V/E version G.01.00 or later) are 6, 9, 10, 1...

Appendix D 751 Subsystem Formal File Designators D Subsystem Formal File Designators Table D-1 lists the formal file designator associated with specific command parameters. Table D-1 Formal File Designators Command Parameter Formal File Designator BASIC commandfile BASCOM inputfile BASIN listfile BA...

Appendix E 757 MPE/iX File Codes E MPE/iX File Codes File codes are recorded in the file label and are available to processes accessing the filethrough the FFILEINFO or FGETINFO intrinsic. Although any user can specify a positive integer ranging from 0 to 32767 or the mnemonic name for this paramete...

Appendix E 761 MPE/iX File Codes NOTE Default is the unreserved file code of 0. 1435 PRINT BRW Print File 1436 RCONF BRW Configuration File 1437 RDICN BRW NM Dictionary File 1438 REXNUM BRW NM Execution File 1441 PIF Reserved 1476 TIFF Tag Image File Format 1477 RDF Revisable Document Format 1478 SO...

762 Appendix E MPE/iX File Codes Using 1090 (LOG) as a designated file code may not yield the number of records you specify in the DISC= parameter. Most files use the number of records specified in the DISC= parameter as the maximum limit; user logging uses this specified number as a minimum.

Appendix F 763 Wildcard Characters F Wildcard Characters In some commands, you may substitute wildcard characters for certain parameters, orparts of parameters, in the list. The wildcard characters count toward the eight characterlimit for user, group, account, and file names. These wildcard charact...

Index Index 765 Symbols $NEWPASS , 234 $NULL , 234 $OLDPASS , 234 $STDIN , 234 $STDLIST , 234 =LOGOFF command , 371 =LOGON command , 373 =SHUTDOWN command , 607 A ABORT command , 38 aborting jobs/sessions , 41 , 371 pending I/O requests , 39 programs/operations , 38 ABORTIO command , 39 ABORTJOB com...