Name

decedi_retr − The decedi_retr command is a utility that moves DEC/EDI data from a secondary, and possibly off-line area to the primary on-line archive area.  The aim of this is to restore data to the on-line system that has previously been archived via the decedi_arch command, so that it can be viewed for auditing purposes or used as the basis of resending some information. 
 
 
 

FORMAT

 
decedi_retr -i inspec [-v] [-d "docid"] [-t "trfnam" ] [-m "mapid" ] [-f arcflg ]
 
 
 
 
 

Flags

-i inspecDefines what the input device is. For example, when using the default retrieve script, which is based on tar, you could enter a tape device, such as /dev/rmt0h. 
 

This parameter is mandatory. 
 

-vSwitches on verbose processing. This displays informational messages describing the current phase of the retrieval and its duration. 
 

-d docidIntroduces docid which specifies which document(s) to retrieve. docid must be within double quotes and may contain the wildcards ’%’(match any single character) or would select all incoming documents while specifying ’-d "APPL1_∗"’ would select all documents sent or received by the application ’APPL1’. docid is not case sensitive and will uppercase all selections before processing. The default is to select all documents. To select none, specify an empty quoted string, ’-d ""’. 
 

-t trfnamIntroduces trfnam which specifies which transmission file(s) to retrieve.  trfnam must be within double quotes and may contain the wildcards ’%’ (match any single character) or with the ’EXMPLE’ connection id. trfnam is not case sensitive and will uppercase all selections before processing. The default is to select all transmissions. To select none, specify an empty quoted string, ’-t ""’. 
 

-m mapidIntroduces mapid which specifies which set of mapper information to retrieve. mapid  must be within double quotes and may contain the wildcards ’%’ (match any single character) or 000500 to 000599 inclusive. The default is to select all mapper runs. To select none, specify an empty quoted string , ’-m ""’. 
 
 

-f <arcflg>Specifies the set of flags that should be passed to the archive mechanism (for example, do not rewind the tape). 
 
 
 
 

Examples

 # decedi_retr -d "APPL1_O_∗ -t "∗EXMPLE" -m "" -i /dev/rz6h -f "-S 40960"
#

 
The above example retrieves all outbound documents from application mapper runs from the tape drive pointed to by the block special file /dev/rz6h. Note that a special flag is passed to the tar utility using the ’-f’ flag. The flag indicates that the tape is 40960 blocks long (i.e. it can hold 20 Mb).
 

 # decedi_retr -d "TEST∗_I_∗" -t "∗" -m "" -i DECEDI_9505Archive.tar -v
initializing retrieve environment...
calling Operating System retrieve shell script
    /usr/sbin/decedi_retr_script...
document APPL-1_I_0000000289 retrieved
document APPL-1_I_0000000290 retrieved
document APPL-1_I_0000000291 retrieved
document APPL-4_I_0000000295 retrieved
document APPL-4_I_0000000296 retrieved
document APPL-4_I_0000000297 retrieved
6 documents retrieved
retrieving all transmissions...
100 transmissions retrieved
no maps requested for retrieval
#
 

 
The above example retrieved all inbound documents from applications whose name begins with ’APPL’, all transmission files and no mapper runs from the file DECEDI_9505Archive.tar and requests that the utility provide informational messages as it works.