DECHO(1)
DECHO(1) ZOAU Command Syntax DECHO(1)
NAME
decho - Echo text to a fully qualified PDS member or sequential dataset.
SYNOPSIS
decho [-adfhv] "text" <DATASET>
-a
Append to the dataset instead of overwriting it.
-d
Print out debug messages.
-f
Force open. Open dataset member in DISP=SHR mode.
When not provided, the default is DISP=OLD.
-h
Display syntax help.
-v
Print out verbose command information.
DESCRIPTION
Write text, which may be multiple lines, to a dataset.
If the -a option is specified, text will be appended to the end
of the existing dataset or PDS member.
If the -a option is not specified, the contents of the dataset
will be overwritten.
decho also accepts text from stdin.
If the provided text starts with a dash (-), it will be treated
like an command line argument. To avoid this, specify a double
dash (--) immediately prior to the text argument. This will
terminate argument processing and treat the next argument as the
text to be echoed. See EXAMPLES for more information.
EXAMPLES
Write 3 lines of text to the dataset TSTRADM.PROG.SYSIN:
decho "Line 1
Line 2
Line 3" tstradm.prog.sysin
Write one line of text to the PDS member TEST.TEXT(MSG).
Then append a second line of text to the PDS member:
decho 'Hello' 'test.text(msg)'
decho -a 'Goodbye' 'test.text(msg)'
Write one line of text to the dataset TSTRADM.PROG.SYSIN:
echo "line 1" | decho "STRADM.PROG.SYSIN"
Write a line of text starting with a hyphen to the dataset
ZOAU.TEST:
decho -- "-Hello, world!" ZOAU.TEST
EXIT VALUES
0
Dataset or PDS member was updated successfully.
non-zero
decho encountered an error. See error messages for details.