Create a 'dchtag' example
MikeFultonDev opened this issue · 1 comments
MikeFultonDev commented
Pattern dchtag after chtag. Possible syntax:
Format:
dchtag -b | -r [-qv] dataset(member) ...
dchtag -c codeset [-qv] dataset(member) ...
dchtag -p [-qv ] dataset(member) ...
Options:
-b
Indicates that the dataset member contains only binary (non-uniformly encoded)
data.
-b is mutually exclusive with the -c or -r options.
-c CODESET
Allows the user to modify the coded character set associated with the
dataset member. CODESET can be a code set name that is known to the system or the
numeric coded character set identifier (CCSID). If a code set name
exists, the numeric CCSID associated with that name is used. -c is
mutually exclusive with the -r and -b options. The command iconv -l
lists existing CCSIDs along with their corresponding code set names.
-p
Prints tag information that is associated with a dataset member. If a code
set name is not associated with the numeric CCSID in the file tag, the
numeric CCSID is displayed instead.
The following example is a sample of the output that you might see:
t IBM-1047 dataset(mem1)
- untagged dataset(mem2)
b binary dataset(mem3)
where:
t
Textcodeset
b
Binary
-q
Suppresses warning messages.
-r
Removes any tagging information that is associated with the dataset member and
sets the status of the file to "untagged". -r is mutually exclusive with the
-b and -c options.
-v
Gives verbose output.
Examples:
Examples
1. To specify a dataset member with IBM-1047 code set, issue:
dchtag -tc IBM-1047 dataset(member)
2. To specify a binary dataset member, issue:
dchtag -b dataset(member)
3. To remove the tag from a file issue:
dchtag -r dataset(member)
Exit Values:
0
Successful completion.
1
dchtag failed to change the tag of a specified dataset member for the following
reasons:
* The alling process does not have appropriate privileges to change dataset member
attributes.
* The dataset member does not have extended attributes.
2
Incorrect command line syntax.