Quick reference for rccbuild
The following table provides a synopsis of the functionality of rccbuild commands, options, and arguments.
For a more detailed description of each command, click the link in the For more information column.
Requirement: You must specify the –h option
with all rccbuild options except the –version option,
which does not make a server request. The rccbuild options are not
positional; you can include them in your request in any order.
Note: The
examples in this table are for illustrating command syntax. You need
to substitute values appropriate to your site for the command parameters.
| To do this task | Issue this command | For more information |
|---|---|---|
| Find out the version of the Remote Build client. | rccbuild –version | Obtaining the Remote Build client version |
| Specify a Remote Build server. | rccbuild –h servermachine@portno… | Specifying a Remote Build server |
| Determine whether a Remote Build server is running on a specific port. No build request is passed. | rccbuild –h servermachine@portno –testServer | Pinging a Remote Build server |
| Specify a build script that resides on the client computer. | rccbuild –h servermachine@portno –f [t|b]client_build_script –b copy_to_name… | Specifying a local build script |
| Specify a build script that resides on the server. | rccbuild –h servermachine@portno –b server_build_script… | Specifying a server-side build script |
| Specify a build script that resides on the server in a PDS that the RCCPROC DD statement in the RCCMVS JCL does not point to. | rccbuild –h servermachine@portno –b server_build_script –proclib mvs_buildscript_library… | Specifying a server-side build script in a nondefault PDS |
| Specify client-based input and dependent files to the build process. | rccbuild –h servermachine@portno –i [t|b|n] input_file –d [t|b|n] dependent_file | Specifying client-based source files |
| Return output files, such as compiled objects, to the client computer. | rccbuild –h servermachine@portno –o [t|b] output_file… | Returning output files to the client computer |
| Keep derived files on the server. | rccbuild –h servermachine@portno –on output_file… | Keeping output files on the server |
| Specify the directory for a z/OS® UNIX® System Services build. | rccbuild –h servermachine@portno –l[a][c] build_directory… | Specifying the directory for a z/OS UNIX System Services build |
| Specify TSO login details. | rccbuild –h servermachine@portno … –au userid –ap password | Sending user IDs and passwords |
| Specify ClearQuest® credentials. | rccbuild –h servermachine@portno … –qu cquserid –qp cqpassword –qdb cqdatabaseset | Sending ClearQuest credentials |
| Specify a worker job name that overrides the default job name. | rccbuild –h servermachine@portno ...–j jobName | Specifying a worker job name |
| Specify worker job account information. | rccbuild –h servermachine@portno…–ja jobAccount | Sending worker job account |
| Specify code pages for the client and server. | rccbuild –h servermachine@portno…–k client_codepage –r server_codepage | Specifying code pages |
| Specify escape codes for file transfers. | rccbuild –h servermachine@portno…–k client_codepage –r server_codepage –ec cc:cc:cc:cc: . . . | Specifying escape codes |
| Set the level for message verbosity. | rccbuild –h servermachine@portno…[–V | –V–V | –V–V–V] | Setting message verbosity |
| Set the condition for valid return codes. | rccbuild –h servermachine@portno…–c condition –n good_rc | Setting the condition for valid return codes |
| Specify a time out factor, in minutes. | rccbuild –h servermachine@portno…–T timeout | Specifying a timeout factor |
| Set environment variables. | rccbuild –h servermachine@portno…–v var1=value var2=value2… | Setting environment variables |
| Pass runtime variables to the build script. | rccbuild –h servermachine@portno…–p build_parameters | Passing variables to build scripts |
| Specify a prefix that is attached to the front of the message files returned by the server (for example, 1234COBC.SYSPRINT). | rccbuild –h servermachine@portno…–P message_prefix | Specifying a prefix for messages returned to the client log file |
| Specify the role of the Remote Build user. This argument also enables you to identify a set of resources that the user's role is authorized to access. | rccbuild -h servermachine@portno -rl roleID | Sending user IDs and passwords |