28.11.2012 Views

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Usage Notes<br />

Examples<br />

resides. This can be specified as a wildcard of an asterisk (*), which matches<br />

any sysplex name. This operand is not needed <strong>for</strong> members within the local<br />

<strong>NetView</strong>'s sysplex.<br />

group_name<br />

Specifies the name of the group. The value can be 1–8 characters in length.<br />

member_name<br />

Specifies the name of the member whose table data is being retrieved or set.<br />

An error message is generated if the member name is <strong>for</strong> a member other than<br />

one created by a START XCF command from the local <strong>NetView</strong> system.<br />

v The XCFTABLE stage command accepts one input stream. If it is connected, the<br />

stage sets the specified field with the input message. For the state field, this can<br />

be1-32bytes in length. This message is passed to the output stream.<br />

v If the XCFTABLE stage command is the first stage, the pipeline returns the data<br />

field on the output stream<br />

v If group_name or plex_name is not unique within the enterprise, use of the<br />

wildcard (*) <strong>for</strong> plex_name can result in errors.<br />

Example: Retrieving the state field in a user-defined XCF group<br />

To retrieve the state field <strong>for</strong> member CNM01 in the user-defined XCF group<br />

SAMPLE in the local sysplex, enter this command:<br />

PIPE XCFTABLE STATFLD SAMPLE.CNM01 | CONSOLE<br />

Example: Retrieving the state field in a <strong>NetView</strong> XCF group in a<br />

local sysplex<br />

To retrieve the state field <strong>for</strong> member CNM01 in the <strong>NetView</strong> XCF group<br />

DSIPLX01 in the local sysplex, enter this command:<br />

PIPE XCFTABLE STATFLD DSIPLX01.CNM01 | CONSOLE<br />

Example: Retrieving the state field using a wildcard character in<br />

an enterprise environment<br />

Assume the local <strong>NetView</strong> system is functioning as an enterprise master, and is<br />

managing a remote XCF group DSIPLX02 in sysplex SAMPPLEX. The label on the<br />

ENT.SYSTEMS statement is REMPLX1. To retrieve the state field <strong>for</strong> member<br />

CNM02, enter this command:<br />

PIPE XCFTABLE STATFLD REMPLX1.SAMPPLEX.DSIPLX02.CNM02 | CONSOLE<br />

PIPE XCFTABLE<br />

Note that a wildcard can be used <strong>for</strong> the label name or the plex name. Any of the<br />

following <strong>for</strong>ms would also work:<br />

v PIPE XCFTABLE STATFLD *.SAMPPLEX.DSIPLX02.CNM02 | CONSOLE<br />

v PIPE XCFTABLE STATFLD REMPLX1.*.DSIPLX02.CNM02 | CONSOLE<br />

v PIPE XCFTABLE STATFLD *.*.DSIPLX02.CNM02 | CONSOLE<br />

Chapter 2. Pipeline Stages and Syntax 275

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!