MikeFultonDev/asmdio

Create a 'dchtag' example

MikeFultonDev opened this issue · 1 comments

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.