Commands

The Help screen in the following figure shows the Commands that are available from the Command line within the Container List. Each of these Commands is described in detail in the following sections.

Container List Commands

ADD

The Add command is used to create a new Container, which may be an Assignment or a Release. See Add-a-New-Assignment and Add-a-New-Release for more information.

FIX

Within Code Pipeline, any list can be customized as required. The easiest way to do this is with Option U - User Preferences, but the Fix command also works to change the column order by “fixing” columns on the left of a display list.

When a list of data occupies many columns, it can sometimes be helpful to fix a column on the left so it does not scroll left or right. By default, the first column in a list is always fixed, but other columns will scroll left and right. To fix a column, type Fix on the Command line, position the cursor in the label header of the column to be fixed, and press Enter.

Changes made with the Fix command are temporary, and they are only maintained for the duration of a Code Pipeline session. If you want to change the sequence in which columns are presented on a more permanent basis, see the SEQ command in conjunction with the Save command, or the User Preference option Session Save.

MSGS

The Msgs command is used to enable/disable the display of Error Message Codes.

Code Pipeline can sometimes generate error messages when, for example, inappropriate operations are entered alongside Tasks in a Task List. These error messages will generally have associated ID= CODE= diagnostic codes which may help to diagnose a problem. However, in many cases, the error message text is sufficient and the diagnostic codes simply take up valuable screen real estate.

The Msgs command will switch the error message format from short to long, or from long to short, depending on the current value.

RESET

The Reset command is used to remove filters and input selections for a list.

If you have entered filters under the label headers for a list—or if you have entered operations alongside items in a list—and you want to re-display the list in its original state with no filters or input selections, you can use the Reset command to re-drive the selection and re-display process.

RLIST

The Rlist command is used to display the Code Pipeline component repository. All Components belonging to applications are recorded in the Code Pipeline repository.

The Rlist command (or its abbreviation RL) provides a convenient way to access and view the repository using natural component identifiers like Type, Name, and Application with wildcard * generic specifications, as required.

The component identifiers can be specified upon entry to the repository list via parameters entered on the command line.

The following two examples demonstrate the Rlist command:

• Enter RL COB MA* PAYR to view all COBOL types with names starting with MA in the PAYR application.
• Enter RL * * HR to view all components recorded for application HR.

If no parameters are entered with the RL command, they will be requested before the repository list function is invoked. The repository list function can also be invoked via option R from the Code Pipeline Main Menu or via the command =R from anywhere within Code Pipeline.

SAVE

The Save command is used to save User Preferences.

When working within Code Pipeline, you can change various personal preferences using commands such as VP to alter the way columns of data are sequenced in a list, along with their respective left/right bounds. The Save command saves your preferences so they are available the next time you use Code Pipeline.

SHOW

The Show command is used to show different Container List groupings. This command provides an alternative to using filters and facilitates a fast path Command line interface to the Container List display.

The Show command has the following format:

where column can be one of the following:

• User
• Appl
• Stream
• Desc
• Asg
• Rel
• Owner
• Type
• Tag
• Hist
• Reset

For example:

• Enter Show User Fred to display the containers that user FRED is connected to.
• Enter Show Type R to display Releases.

SORT

Most Code Pipeline Lists can be sorted by column. Position the cursor in any column header and press Enter to sort on that column.

Alternatively, the Sort command is used to sort a list of data by a particular column.

A list of data in Code Pipeline can be sorted on any column by entering the Sort command followed by the associated column label header. The label headers entered with a sort command can usually be abbreviated to two or three characters. Common labels like Component Type and Name, Level, Application, Date, Set, and Release can be abbreviated to one character.

For example:

• Enter Sort N to order a list by Component Name.
• Enter Sort D to order a list by Date.
• Enter Sort A to order a list by Application.
• Enter Sort ASG to order a list by Assignment.

VP

The VP command lets you change the way Code Pipeline lists are displayed. Using this function, you can alter the column sequence and the size and bounds (left and right boundaries) for most columns. This enables you to see the data that is most appropriate for your requirements.

Changes you make using this function are applied to the list you came from when you press End, and they stay current for the remainder of your Code Pipeline session. If you are satisfied with your changes when you return to the list you are working with, you can use the Save command to save them across Code Pipeline sessions.

Use the Reset command to load the system defaults for the Code Pipeline list you are working with. Use the Cancel command at any time to cancel out of this function and ignore all changes. Press End to save your changes and return to the list you came from.

VP Option 1 – Change column sequence

The left-to-right column order for the list you are working with is presented top to bottom, so that the leftmost column appears at the top and the rightmost column appears at the bottom.

To move a column to a new location in the current list:

1. Type M alongside the column you want to move.
2. Type A (After) or B (Before) alongside the destination location.

For example, to move Application before Name in the following list, use the B and M commands (in a way similar to ISPF Edit), and press Enter.

VP Option 2 – Change column bounds

Column Bounds define the Left and Right character positions for columns of data in a list. They enable you to customize your own view of a column so you only see data that is meaningful to you.

The column bounds for each column in the list you are working with are displayed alongside their respective column labels when you select the View Preferences function. The example in the following table shows that column Name can have a maximum size of 64 characters, but is currently only showing positions 1 through 20.

To change the bounds for a column, simply overtype the Left and Right values for a column. For example, to remove the year portion of a date field which is normally presented in 10 columns in the format YYYY MM DD, enter values of 6 and 10 for Left and Right alongside the Date column.

Change Column Bounds

WORK

The W (Work List) command provides different views of Work in Progress that would typically be used by QA staff or Project Leaders. This List can be invoked as follows:

• With the W line command which shows the work list specifically for that module. (Filters can then be overtyped to show basically any view.)
• With the WORK Command line command from Code Pipeline Task and Container Lists.
• Using Option W from the initial entry panel, or =W from anywhere in Code Pipeline.

The W (Work List) command is very powerful because you can actually perform non-update operations such as Browse and Compare from this display.

By default, the Work input panel sets the filter to display work in the change cycle tagged with your UserID. Use the input fields to see data by Type, by User, by Level, and so on.

To see Historical (Audit Trail) information, change Hist to Y and give a date range. It is easy to see updates to Production for Application ABC in the last month, or modules tagged to a specific Release, for example. As in every Code Pipeline List, you can scroll left and right. Option U - User Preferences can be used to change the default column order.

The following table describes the Input fields on the Work input panel: