SAVOBJIFS SAVE OBJECT TO IFS TAAIFTG
The Save Object to IFS command simplifies saving objects to an IFS
stream file in order to allow the stream file to be used as an E mail
attachment. The command does the following: 1) Creates a save file
in QTEMP with the name of the library 2) Uses SAVOBJ to the save file
3) Uses CPYTOSTMF to copy the save file to the specified stream file.
See the companion tool RSTOBJIFS.
You must have the special authority *SAVSYS or the object existence
right to the objects being saved.
SAVOBJIFS uses the CPYTOSTMF default for the AUT parameter to set the
authority to a new stream file. If the stream file exists, no
authority change occurs.
A typical SAVOBJIFS command would be:
A library qualifier must be entered.
Several defaults occur:
** The default for the OBJTYPE parameter is *ALL for all object
** The default for the STMFDIR parameter is *HOME meaning the
user profile must have a home directory and the directory must
** The default for the stream file name is *LIB meaning the same
name as the qualified library.
** The default for the stream file extension is '.stmf'.
The home directory would be retrieved and concatenated with the
stream file name and extension to produce an IFS stream file name
The file can then be attached to an E mail and sent to another i5
If the stream file does not exist, it is added. If it does exist, it
SAVOBJIFS escape messages you can monitor for
TAA9896 No objects exist to be saved
TAA9897 The stream file directory was not found
Escape messages from based on functions will be re-sent.
Command parameters *CMD
OBJ The name or generic name of the object to be saved.
Up to 300 entries may be made. All objects must be
in the same library.
LIB The library where the objects exists.
OBJTYPE The type of object to be saved. The default is *ALL
for all types. Up to 100 may be specified. For a
list of the valid types, use the prompter.
STMFDIR The stream file directory. The default is *HOME
meaning to use the home directory stored in the user
profile. A home directory must be specified in the
user profile and the directory must exist.
A directory entry may be specified such as
Up to 5000 characters may be entered and mixed case
STMF The stream file name to be used. The default is
*LIB meaning the same name as the library name
Up to 300 characters may be entered and mixed case
If the stream file does not exist, it is added. If
it does exist, it is replaced.
DTACPR A parameter for whether to compress the data as it
is written to the save file. The value is passed
thru to the SAVOBJ DTACPR parameter. The default is
The other values are *YES, *LOW, *MEDIUM, or *HIGH.
TGTRLS The target release to be used. *CURRENT is the
default for the current release. Use the prompter
to see the supported values.
STMFEXT The stream file extension if any that is added to
the IFS stream file name. The default is '.SAVF'.
A different extension may be used or the special
value *NONE meaning no extension is added.
The following TAA Tools must be on your system:
CHKIFSE Check IFS entry
CHKOBJ3 Check object 3
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVHOMDIR Retrieve home directory
RTVSAVFD Retrieve save file description
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SAVOBJIFS *CMD TAAIFTG QATTCMD
TAAIFTGC *PGM CLP TAAIFTGC QATTCL
Added to TAA Productivity tools December 1, 2004