HP 3000 Manuals HP 3000 Manuals
PURGE
Purges an entity which was created with the CREATE command from the
Dictionary.
Syntax
[option] PURGE subcommand
P
Use the PURGE command to purge an entity and all references to that
entity from the Dictionary. A subcommand is used to identify the kind of
entity to be purged. For example, PURGE FILE purges the specified file
and all references to the file from the Dictionary. That is, if a master
file and an associated primary path element are purged, the associated
sort element, primary path, and path file information are purged as well.
A complete list of entities that can be purged is given below under
Subcommands.
Before the PURGE command is implemented, the Dictionary allows you to
cancel the command with the following prompt:
DELETE ALL ENTRIES(N/Y)?
A response to this prompt other than Y cancels the PURGE command.
Subcommands
Any of the following subcommands can be used with the PURGE command:
CATEGORY purges the category and all references to it
CLASS purges the security class and all references to
it
ELEMENT purges the data element and all references to
it
FILE purges the file and all references to it;
optionally purges related files and associated
elements
GROUP purges an HP Inform group and all references to
it
LOCATION purges the location and all references to it
PROCEDURE purges the procedure and all references to it
Example
> PURGE ELEMENT
ELEMENT> Element 1 < Identifies element
DELETE ALL ENTRIES(N/Y)?> Y to be purged.
ALL ENTRIES DELETED Confirms request to
purge element.
> New command prompt.
> PURGE FILE
FILE> Base1 < Identifies BASE file
to be purged.
DELETE ALL ENTRIES(N/Y)?> Y Confirms request to purge
Base1.
PURGE RELATED CHILD FILES(Y/N)?> Y Requests that all related
child files be purged.
PURGE ASSOCIATED ELEMENTS(Y/N)?> Y Requests that child file
elements not associated
with another file be
purged.
LIST ALL PURGED ENTITIES(Y/N)?> Y Requests that purged
entities be displayed.
FILE PURGED: BASE1
CHILD FILES: FILES PURGED:
ELEMENTS: ELEMENTS PURGED:
HP-DIV-MSTR HP-DIV-MSTR
HP-DIV-NO
HP-DIV-NAME
HP-GROUP
COMMODITY-MSTR COMMODITY-MSTR
COMMODITY-TYPE
COMMODITY-NAME
VENDOR-DETAIL VENDOR-DETAIL
COMMODITY-TYPE
C-VEND-NUM C-VEND-NUM
VEND-NAME
Q1-RATING Q1-RATING
Q2-RATING Q2-RATING
Q3-RATING Q3-RATING
> 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.
You enter: You are prompted for:
SUB-
COMMAND COMMAND PROMPT
PURGE CATEGORY * CATEGORY
DELETE ALL ENTRIES(N/Y)?
PURGE CLASS * CLASS
* DELETE ALL ENTRIES(N/Y)?
PURGE ELEMENT * ELEMENT
DELETE ALL ENTRIES(N/Y)?
PURGE FILE * FILE
1. if FILE is BASE or VPLS file
DELETE ALL ENTRIES(N/Y)?
PURGE RELATED CHILD FILES(Y/N)?
You must respond YES, Y, NO, or N;
no default response occurs.
ANSWER YES OR NO.
Issued if response to above was not
YES or NO.
PURGE ASSOCIATED ELEMENTS(Y/N)?
Issued if response to PURGE RELATED
CHILD FILES was YES.
You must respond YES, Y, NO, or N;
no default response occurs.
ANSWER YES OR NO.
Issued if response to above was not
YES or NO.
LIST ALL PURGED ENTITIES(Y/N)?
Issued if response to PURGE RELATED
CHILD FILES or PURGE ASSOCIATED ELEMENTS
was YES.
2. if FILE is MAST, DETL, AUTO, MPEF,
KSAM, or FORM file
DELETE ALL ENTRIES(N/Y)?
PURGE ASSOCIATED ELEMENTS(Y/N)?
You must respond YES, Y, NO, or N.
No default response occurs.
ANSWER YES OR NO.
Issued if response for above was not
YES or NO.
LIST ALL PURGED ENTITIES(Y/N)?
Issued if response to PURGE ASSOCIATED
ELEMENTS was YES.
PURGE GROUP * GROUP
* DELETE ALL ENTRIES(N/Y)?
PURGE LOCATION * LOCATION
DELETE ALL ENTRIES(N/Y)?
PURGE PROCEDURE * PROCEDURE
DELETE ALL ENTRIES(N/Y)?
Prompts
Depending on the subcommand used, one of the following prompts is issued:
ANSWER YES OR NO You must respond to this prompt with Y, Yes, N
or No.
CATEGORY Enter the name of an existing category which is
to be purged from the Dictionary (20 characters
maximum).
CLASS Enter the identifying number of an existing
security class which is to be purged from the
Dictionary (0 to 9999).
DELETE ALL ENTRIES(N/Y)? Enter Y to purge the entity and all references
to it from the Dictionary. Note that entering
N or pressing [[RETURN]] in response to this
prompt means that no action is taken.
ELEMENT Enter the name of an existing data element
which is to be purged from the Dictionary (20
characters maximum).
FILE Enter the name of an existing file which is to
be purged from the Dictionary (20 characters
maximum).
GROUP Enter the name of an existing HP Inform group
which is to be purged from the Dictionary (20
characters maximum). NOTE: $MENU cannot be
purged.
LIST ALL PURGED Enter Y or press [[RETURN]] to display all
ENTITIES(Y/N)? related files and elements as well as files and
elements that were purged. Enter N if you do
not want this listing.
LOCATION Enter the name of an existing physical location
which is to be purged from the Dictionary (20
characters maximum).
PROCEDURE Enter the name of an existing procedure which
is to be purged from the Dictionary (20
characters maximum).
PURGE RELATED CHILD Enter Y to purge all related child files and
FILES(Y/N)? all references to these files. Note that a
child file is not purged if it is related to
another parent file. Enter N to purge only the
specified file and all references to that file.
You must enter YES, Y, NO, or N; there is no
default response.
PURGE ASSOCIATED Enter Y to purge all associated (i.e., member)
ELEMENTS(Y/N)? elements and all references to these elements.
Note that an element is not purged if it is
associated with other files or with other
elements. Enter N if you do not want
associated elements purged. You must enter
YES, Y, NO, or N; there is no default response.