HP e3000 MPE/iX System Software Maintenance Manual (Release C.75.00) (30216-90344)

Appendix G
HP Stage/iX Reference
HP Stage/iX Commands
281
Example
To mark staging area “Stage_1” as complete:
STAGEMAN> COMPLETE STAGE_1
CREATE (CR)
The CREATE command will create an empty HP Stage/iX staging area. At the time the staging area is created,
you are allowed to specify a brief description for the staging area.
Staging areas are normally created by HP Patch/iX. A default description is associated with the staging area
at that time, but you can change that description using the CHANGE command.
When a staging area is initially created, it will be considered “invalid”. It will remain invalid until it is
validated by the VALIDATE command.
You must specify a name for the staging area to be created. The staging area name must be a valid HP
Stage/iX staging area name (see below), and cannot be the name of a staging area that already exists. The
name “BASE” is reserved by HP Stage/iX to refer to the Base system software environment (see the SET
command). You are not allowed to create a staging area named “BASE.” This includes all forms of the word
BASE, Base, or base.
HP Stage/iX staging areas are created as sub-directories under the HP Stage/iX root directory. The HP
Stage/iX root directory is /SYS/hpstage/. The staging area “stage_1” for example would be kept in the MPE
directory /SYS/hpstage/stage_1/.
The CREATE command can be abbreviated CR.
Syntax
CREATE [STAGE=]stage_name [[;DESC=]quoted_string]
Parameters
[STAGE=]stage_name (required)
This parameter specifies the name to be given to the newly created staging area. The staging area name can
be up 16 characters in length. The staging area name must be a valid MPE/iX directory name. For this
reason, the staging area name cannot contain a “/” character. It may contain letters (upper or lower case),
numbers, and the special characters “_”, “-”, and “.”.
Staging area names are case sensitive. “STAGE1” is not equivalent to “stage1” or “Stage1”.
[;DESC=]quoted_string (optional)
This parameter must be a quoted string if it contains any delimiter characters (like blanks, commas,
semi-colons, or any other punctuation characters). The description can be any string up to 128 characters in
length.
Example
To create a new staging area called “new_stage” with the description “misc. patches”:
STAGEMAN> CREATE NEW_STAGE;DESC="MISC.PATCHES"
DELETE (DEL)
The DELETE command will delete an HP Stage/iX staging area and its contents. If the system is currently
booted from an HP Stage/iX staging area, then that staging area cannot be deleted. In addition, if a staging
area has been designated for the next boot (see SET command), then it cannot be deleted.