Dovetailed Technologies

Name

cozclient — run a zos command from a remote system

Synopsis

cozclient [OPTION...] command [command-options...]
cozclient -ssh [ssh-options...] [user]@host [OPTION...] command [command-options...]
cozclient -v
cozclient -h
    

Description

The cozclient command allows a remote process to excute the z/OS command [command-options...]. Input (stdin) to the command is provided by the remote process and Output (stdout) from the command is redirected back to the remote process. Error output (stderr) from the command can be routed back to the remote client or to the Co:Z Server's stderr stream (if using the Co:Z Launcher).

The z/OS path when executing the command will by default be set to /bin:$COZ_HOME/bin.

The cozclient command runs in one of the following environments:

  • remotely, from a client which was started by Co:Z launcher.

  • remotely, from a client that started a durable session to the server using the cozcontrol command.

  • remotely, from a client-initiated ssh connection: -ssh option

Options

-ssh [ssh-options...] [user]@host

Specifies a remote invocation of cozclient using a client-initiated ssh connection to the given z/OS user@host. The optional stdin, stdout, stderr format options, if specified, must be before the -ssh option.

-h

display help and exit.

-i stdin_format

t

stdin sent to the command in text format. Characters are converted from the remote client's codepage to to the active z/OS codepage before being sent to the command.

b

stdin sent to the command in binary format

n

no stdin is sent to the command. This is the default.

-o stdout_format

t

stdout from the command is sent to the remote client in text format. Characters are converted from the active z/OS codepage to the remote client's codepage. This is the default.

b

stdout from the command is sent to the remote client in binary format

n

stdout from the command is discarded

-e stderr_format

t

stderr from the command is sent to the remote client in text format. Characters are converted from the active z/OS codepage to the remote client's codepage. This is the default when -ssh is specified or a cozcontrol durable session is used.

b

stderr from the command is sent to the remote client in binary format

s

stderr from the command is sent to the Co:Z Server's stderr stream (generally SYSOUT). This is the default when using CoZLauncher.

-v

display the current version and exit.

Examples

Remote Co:Z Launcher Examples

cozclient -in -ot ls -al

Run the ls command on z/OS. Output is converted to the client codepage and is directed to the remote system's stdout stream.

cozclient -in wto "MESSAGE TO CONSOLE"

Use the Co:Z toolkit z/OS wto command to send a message to the z/OS console.

Remote Client SSH Connection Examples

cozclient -ssh user@myzos2.com ls -al

Run the ls command on z/OS.

cat jcl.txt | cozclient -ssh user@myzos2.com submit

Submits a job to the internal reader on z/OS. The JCL is contained in the local file jcl.txt.

Copyright© 2009-2017 Dovetailed Technologies, LLC. All rights reserved.
Co:Z® is a registered trademark of Dovetailed Technologies, LLC.