HP 3000 Manuals HP 3000 Manuals
UPDATE
Updates an association between entities which was established with the
ADD command.
Syntax
[option] UPDATE subcommand
U
Use the UPDATE command to change the association for an element, a file,
or a procedure established with the ADD command. A complete list of
entities for which an association can be changed is given below under
Subcommands.
The subcommand identifies the type of entity association that is changed.
For example, UPDATE CATEGORY, changes the description of the association
or the element alias name.
Subcommands
Any of the following subcommands can be used with the UPDATE command:
CATEGORY updates a data element to a category
association
CLASS updates a data element to a user security class
association
CLASS-FILE updates a file to a user security class
association
CLASS-GROUP updates a group to a security class association
FILE updates a data element to a file association
FILE-LOC updates a file to a location association
GROUP updates a data element to an HP Inform group
association
PROCEDURE updates a data element to a procedure
association
PROCEDURE-LOC updates a procedure to a location association
Example
> UPDATE CATEGORY
CATEGORY> Marketing < Category's name.!!
ELEMENT> Account < Element to be updated.
EDIT DESCRIPTION(Y/N)? N No, to edit description
of the relationship.
ELEMENT ALIAS:
ACCOUNT Current alias.
ELEMENT ALIAS> Account-Marketing < New element alias.
ELEMENT> [[RETURN]] to end the
command.
> New command prompt.
Subcommand Prompts
For the prompts shown with an asterisk (*), you must enter a response
other than [[RETURN]] in order to implement the command string. Two
asterisks (**) next to a prompt indicate that this prompt and those which
follow are repeated until [[RETURN]] is pressed in response to this
prompt.
You enter: You are prompted for:
SUB-
COMMAND COMMAND PROMPTS
UPDATE CATEGORY * CATEGORY
** ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
ELEMENT ALIAS
UPDATE CLASS * CLASS
** ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
ACCESS CAPABILITY
UPDATE CLASS-FILE * CLASS
** FILE
EDIT DESCRIPTION(Y/N)? Not issued if file type is
MPEF, KSAM, or VPLS.
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION or if file type
is MPEF, KSAM, or VPLS.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
ACCESS CAPABILITY Not issued if file type is
MPEF, KSAM, or VPLS.
UPDATE CLASS-GROUP * CLASS
** GROUP
* EDIT COMMAND>>
UPDATE FILE * FILE
PRIMARY/SECONDARY(P/S)? Issued if file type is KSAM,
MPEF or MPER.
** ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
1. if file type is MAST:
ELEMENT ALIAS
NEW KEY ELEMENT(N/Y)? Issued if element is
not the key.
2. if file type is AUTO, MPEF, MPER or FORM:
ELEMENT ALIAS
FIELD NUMBER Issued if file type is FORM.
3. if file type is DETL:
ELEMENT ALIAS
PATH FILE
SORT ELEMENT Issued if element is a search
item.
CANCEL PRIMARY PATH(N/Y)? Issued if element is
a search item and the primary
path.
PRIMARY PATH(N/Y)? Issued if element is a search
item but is not the primary
path.
4. if file type is KSAM:
ELEMENT ALIAS
CANCEL KEY(N/Y)? Issued if element is in the
Primary format and is currently
a KSAM key.
KEY ELEMENT(N/Y)? Issued if element is in the
Primary format, is not
currently a KSAM key and
element is not TYPE B, S or *.
NEW PRIMARY KEY(N/Y)? Issued if element is in the
Primary format, is a key
element but not the primary
key.
CANCEL PRIMARY KEY(N/Y)? Issued if element is in
the Primary format and is
currently a primary key.
DUPLICATE KEYS(N/Y)? Issued if element is in the
Primary format, is a key
element and duplicate keys
are currently not allowed.
CANCEL DUPLICATE KEYS(N/Y)? Issued if element is
in the Primary format, is a
key element and duplicate
keys are currently allowed.
UPDATE FILE-LOC * LOCATION
** FILE
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued if Yes to EDIT
DESCRIPTION.
FILE SIZE Issued if file type is
MPEF or KSAM.
FILE ALIAS
UPDATE GROUP * GROUP
** ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
ELEMENT ALIAS
FILE
PARENT FILE Issued if file belongs to
more than one database.
VALUE AS A LINK
CHANGE ELEMENT TO DISPLAY(N/Y)? Issued if element
is currently nondisplay.
CHANGE ELEMENT TO NONDISPLAY(N/Y)? Issued if
element is currently
display.
UPDATE PROCEDURE * PROCEDURE
** ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
ELEMENT ALIAS
UPDATE PROCEDURE-LOC * LOCATION
** PROCEDURE
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
EDIT DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
PROCEDURE ALIAS
Prompts
Depending on the subcommand used, one or more of the following prompts is
issued:
ACCESS CAPABILITY Enter a new type of capability to be given to
the user security class for the file or element
using one of the following:
If the subcommand is:
CLASS-FILE - enter one of the following:
R = read only
W = read, write, modify
X = null read/write list "(/)"
CLASS - enter one of the following:
R = read only
U = read and update only
M = read, write and modify
X = null read/write list "(/)"
Refer to the IMAGE Reference Manual for a
detailed explanation of the meanings of user
class access capabilities. DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
CANCEL DUPLICATES (N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y or Yes if
duplicate key values are no longer allowed for
this KSAM file. DEFAULT is N.
CANCEL KEY(N/Y) Enter a Y if the data element is no longer to
be a key in the KSAM file.
CANCEL PRIMARY This prompt generates data that will be used by
KEYS(N/Y)? the DICTCDE utility. Enter Y or Yes if this
element is no longer a primary key. DEFAULT is
N.
CANCEL PRIMARY Enter Y or Yes if the data element is no longer
PATH(N/Y)? to be the primary path.
CATEGORY Enter the name of an existing category used in
the association (20 characters maximum).
CHANGE ELEMENT TO Enter Y to change the element to a display
DISPLAY(N/Y)? element. This means it will be displayed for
reporting on HP Inform's Data Names Menu.
CHANGE ELEMENT TO Enter Y to change the element to a nondisplay
NONDISPLAY(N/Y) element. This means it will not be displayed
for reporting on HP Inform's Data Names Menu.
CLASS Enter a positive numeric value which is the
identifying number (0 to 9999) of the existing
user security class used in the association.
If the subcommand used is CLASS-GROUP, enter a
numeric value (0 to 9999) which is the
identifying number of the INFO type user
security class.
DUPLICATES(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y or Yes to allow
this key to have duplicate key values for this
KSAM file. DEFAULT is N.
EDIT ATTRIBUTES (Y/N)? Enter an N and the prompts to edit the
attributes will not be generated (see
Subcommand Prompts for which attributes can be
changed).
EDIT COMMAND>> Enter one of the EDIT COMMANDS described in
Using Edit Description Commands in Section III.
EDIT DESCRIPTION (Y/N)? Enter an N if editing is not to be done for the
textual description of the association.
ELEMENT Enter the name of an existing data element used
in the association (20 characters maximum).
ELEMENT ALIAS Enter the name by which the data element is
known within the file. The maximum characters
allowed are:
15 for FORM
16 for MAST, AUTO or DETL
20 for MPEF, MPER or KSAM
60 for CATEGORY
20 for an HP Inform GROUP
16 for PROCEDURE
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
Note that HP Inform and Report will not be able
to retrieve the values of an element from an
IMAGE data set if the response to the ELEMENT
ALIAS prompt of the ADD FILE command string is
not the actual name of the data element in the
data set.
FIELD NUMBER Enter the field number of this element on the
VPLUS form. DEFAULT is 0.
FILE If the subcommand is:
CLASS-FILE or GROUP - enter the name of a file
(20 characters maximum). The file type must be
one of the following:
MAST IMAGE manual master data set
AUTO IMAGE automatic master data set
DETL IMAGE detail data set
KSAM KSAM file
MPEF MPE sequential file
MPER MPE relative file
VPLS VPLUS forms file
FILE - enter the name of a file (20 characters
maximum). The file type must be one of the
following:
MAST IMAGE manual master data set
AUTO IMAGE automatic master data set
DETL IMAGE detail data set
KSAM KSAM file
MPEF MPE sequential file
MPER MPE relative file
FORM VPLUS form
FILE ALIAS Enter a new name by which the file is to be
known within the location (8 characters
maximum). DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
FILE SIZE Enter a new value for the number of records of
the file in the location (0 to 999999999).
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
GROUP Enter the name of an existing HP Inform group
used in the association (20 characters
maximum).
KEY ELEMENT (N/Y)? Enter a Y if the data element is to become the
key element in the KSAM file.
LOCATION Enter the name of an existing location used in
the association (20 characters maximum).
NEW KEY ELEMENT (N/Y)? Enter a Y if the data element is to become the
new key item for the MAST file.
NEW PRIMARY KEY (N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter a Y or Yes if this
element is to be the new primary key for this
file. Any previous primary key will be
canceled when Y or Yes is entered as a response
to this prompt. Enter N or No is this element
is not to be the primary key . DEFAULT is N.
PARENT FILE Enter the name of an existing file (20
characters maximum) that is the parent of the
database set specified in response to the FILE
prompt. The file type must be type BASE (IMAGE
database).
PATH FILE Enter the name of an existing file of type MAST
or AUTO that is the new chain header for a
detail set path (20 characters maximum). A
blank value indicates that the data element is
no longer to be a search item in the DETL file.
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
PRIMARY PATH (N/Y)? Enter a Y if the data element is to become the
primary path. If another data element already
exists as the primary path, a Y response
automatically cancels it.
PRIMARY/SECONDARY (P/S)? Enter P (or press [[RETURN]]) if the element to
be updated is in the primary format for the
file. Enter S if the element is in the
secondary format for the file. (See the
discussion of the ADD command for more
information on primary and secondary formats.)
DEFAULT is P.
PROCEDURE Enter the name of an existing procedure used in
the association (20 characters maximum).
PROCEDURE ALIAS Enter a new name by which the procedure is to
be known within the location (8 characters
maximum). DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
SORT ELEMENT Enter the name of an existing data element that
is the new sort item for a sorted chain (20
characters maximum). This prompt is only
issued if a path file exists. A blank value
(pressing the space bar followed by [[RETURN]])
indicates that the chain is no longer sorted.
DEFAULT: Pressing [[RETURN]] following this
prompt indicates no change.
VALUE AS A LINK Enter -1, 0, or a positive integer to specify
which elements should preferably be used in
linking files. The numbers indicate the
following:
-1 The element can not be used for
linking.
0 The element may or may not be
used for linking (DEFAULT).
1 or greater The element should be used as a
link when possible; elements
assigned a positive link value
form a prioritized list to be
used when it is necessary to link
files (the lower the positive
integer, the higher the
priority).