Writer instructions

Purpose

Use this page to display a banner announcement on each page of the space. Create the Space announcements page in the master space, outside of the Home branch.

You can version the Space announcements page to enable different banners to be published into different target spaces, however, the banner that is displayed in the versioned (master) space itself only displays the most recently-published banner.  If you find errors in the banner area of your versioned space and you are sure the Space announcements page is set up correctly, try publishing the page to the same space.

For more information, see Space-announcements-banners.

Removing

When an announcement is no longer needed, remove the BMC Space Banner macro.

Translation

Localized spaces using the L10n Viewport theme must change the name of this page to Space announcements l10n.  See Configuring-the-Scroll-ViewPort-theme-for-translated-spaces.

Usage

Choose one or none of the following BMC Space Banner macros.

If your space requires another kind of announcement, you can use this page in coordination with your team lead and editors.

When should I use a space announcement banner?

Use the space organization announcement after you change the content from a book-like organization (such as User Manual, Configuration Manual, and Administration Guide) to the product model.

Use the latest version announcement to push traffic to later versions. You do not need to add this to every previous version, but if you have a specific reason that you want users to be aware—for example, Google searches show content for an obsolete version—use the banner to help users find a relevant version.

When an announcement is no longer needed, remove the BMC Space Banner macro.

Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Step 5—MVS Selection Criteria

The following figure is displayed when you enter Yes in the Edit Object Selection Criteria field on the Extract - MVS Driving Object screen.

MVS Selection Criteria Menu

 File-AID/RDX - Selection Criteria Menu - TEMPORARY ----------------------------
 Option ===> 2

                                                                  -Status-
       1  OPTIONS      - Enter selection criteria options         default
       2  FORMATTED    - Edit formatted selection criteria        0   sets








 Use VIEW to display selection criteria summary
 Use END to save selection criteria & return to dataset specification
 Use CANCEL to cancel changes & return to dataset specification

To specify formatted selection criteria :

In this field…

Do the following:

Option

Type 2

Press Enter

File-AID/RDX continues with the Formatted Selection Criteria for the MVS file ORDERTAB.

Field Names and Descriptions

The following list describes all of the fields on this screen.

FIELD

DESCRIPTION

1 OPTIONS

Options allow you to specify a particular starting point in the file and set limits on the number of records processed.

2 FORMATTED

Create and edit formatted selection criteria, which allow you to select records based on data within a field specified by a record layout.

Status




Specifies the status of the temporary selection criteria

Message

Explanation

OPTIONS

DEFAULT shows that the default options have not been modified. NOT DEFAULT indicates that the options have been modified.

FORMATTED

Specifies the number of sets of criteria that are specified. A set of selection criteria is defined as a single expression that can lead to the selection of a record. A set may test for one condition or several conditions. The conditions can be ANDed together and several conditions separated by commas create nested OR conditions within a set.

Primary Commands

The following list identifies the primary commands available from this screen. For details on the command, see File-AID/Related Data XPERT Reference.

COMMAND

DESCRIPTION

CANCEL

Returns to the Selection Criteria Specification screen and clears all changes made to the selection fields.

END

Saves the current selection criteria display in the selection criteria file and exits the Selection Criteria Menu without clearing the selection fields.

VIEW

Displays the View Criteria screen, which summarizes the options and formatted selection criteria sets into a scrollable display.

MVS Formatted Selection Criteria

The following figure appears after you entered Option 2 on the Selection Criteria Menu screen.

MVS Formatted Selection Criteria screen

 File-AID --- Formatted Selection Criteria -------------------------------------
 Command ===> VIEW                                             SCROLL ===> PAGE
 SET  1 OF  1           PROD001-ORDER-TABLE                      GBL = N
 ---- FIELD LEVEL/NAME ------- -FORMAT- RO ----+----1----+----2----+----3----+--
 ******************************* TOP OF DATA ***********************************
 5 COBOL-ORDER-TABLE SYNC      193/GRP                                          
   10 ORDER-NUMBER               6/AN                                           
   10 CUST-NUM                   6/AN   =  CW3375                               
   10 SOC-SEC-NUM               11/AN                                           
   10 CREDIT-CARD-NUM           16/AN                                           
   10 ORD-TYPE                   8/AN                                           
   10 ORD-DATE                  10/AN                                           
   10 ORD-STAT                   8/AN                                           
   10 ORD-AMOUNT                 5/PS                                           
   10 ORD-DEPOSIT                5/PS                                           
   10 ORD-LINE-COUNT             4/BI                                           
   10 SHIP-CODE                  2/AN                                           
   10 SHIP-DATE                 10/AN                                           
   10 ORD-DESCRIPTION SYNC     102/GRP                                          
     49 ORD-DESCRIPTION-LEN      2/BI                                           
     49 ORD-DESCRIPTION-LEN-TEXT                                                
                               100/AN                                           
                            (POS 38-74)                                         
             Use VIEW command to browse selection criteria summary

To specify Formatted selection criteria for ORDERTAB:

In this field…

Do the following:

RO

Type = for field CUST-NUM

Data

Type CW3375 for field CUST-NUM

Command

Type END

Press Enter

File-AID/RDX returns to the MVS Selection Criteria Menu.

To view the entered selection criteria for ORDERTAB:

In this field…

Do the following:

OPTION

Type VIEW

Press Enter

File-AID/RDX proceeds to the View MVS Criteria screen.

Field Names and Descriptions

The following list describes all of the fields on this screen.

Important

The Starting record key field and Starting RBA or RNN field are exclusive of each other.

FIELD

DESCRIPTION

RO

















Specify a relational operator. Possible values are:

EQ, =

Equal to

NE, ¬=, !=

Not equal to

GT, >

Greater than

GE, >=

Greater than or equal to

LT, <

Less than

LE, <=

Less than or equal to

CO

Contains; scans the specified field for the presence of a data value. CO works on an equal condition.

NC

Not contains; scans the specified field for the absence of a data value. NC works on a not equal condition.

BT

Between; within a range of two values (endpoints inclusive). The value is greater than or equal to the first endpoint and less than or equal to the last endpoint.

NB

Not between; outside a range of two values (endpoints exclusive). The value is less than the first endpoint or greater than the last endpoint.

VA

Valid numeric or packed data based on the field format.

NV

Not valid numeric or packed data based on the field format.

NO

Bits are not ones (Mask data value only).


MX

Bits are mixed, ones and zeros (Mask data value only).


FM

Field mask.

File-AID/RDX is distributed with a default value of EQ (equal) for relational operator.

Important

  • The CO and NC relational operators can be specified only for alphanumeric fields (PIC X for COBOL; CHAR or PIC X for PL/I).
  • File-AID/RDX does not currently support selection criteria that use numeric fields that specify a leading and/or separate sign.

data value

For fields with relational operators other than BT and NB, you specify the field value to use in the comparison. For relational operators BT and NB, specify your Data Value as two values separated by a colon (:). The values may be hex strings, character strings, or numeric tests.

To compare an alphanumeric field to blanks (hexadecimal 40s), leave the data value column blank.

Bit Mask Data

Bit Mask data must be 0s or 1s, neither colon ( : ) nor comma ( , ), must be the same length as the number of bits in the bit field, and up to 255 bits supported.

Bit Mask data must have at least one 1 for Relational Operator EQ, NE and NO, at least two 1s for Relational Operator MX.

Primary Commands

The following list identifies the primary commands available from this screen. For details on the command, see File-AID/Related Data XPERT Reference.

COMMAND

DESCRIPTION

ALIGN (AL)

Controls display of ALIGNED/UNALIGNED term for PL/I data.

ARRAY (AR)

Controls display of array declaration information for PL/I data.

BACK

Positions the display to the previous criteria. Synonym for LEFT.

CANCEL (CAN)

Returns to main panel without saving current updates.

CAPS

Sets caps mode. CAPS ON is not case-sensitive in the search to match the selection criteria. Specify CAPS OFF for a case-sensitive search. This command is valid only on a new criteria display.

DELETE (DEL, D)

Delete a selection set.

DISPLAY (DIS)

Specifies a display format.

DOWN

Scrolls down.

END (E)

Terminates display of the Formatted Selection Criteria screen and returns to the Selection Criteria Menu.

FILLER (FILL)

Controls display of FILLER fields..

FORWARD (FWD)

Positions the display to the next criteria. Synonym for RIGHT.

GROUP

Controls the display of occurrences of group-level items.

INPUT/ INSERT (I)

Inputs/inserts a new formatted selection criteria set.

LEFT (L)

Positions the display to the previous criteria. Synonym for BACK.

LOCATE (LOC)

Scrolls directly to the specified record layout line.

LR

Positions the display to the specified criteria number.

OCCURS (OCC)

Controls the display of array declaration items.

OFFSET

Displays field offsets.

OPT (O, 1)

Displays the Selection Criteria Options screen.

PROFILE (PROF)

Displays profile information lines.

REFLNG

Controls the display of BIT/CHAR REFER field length reference lines for PL/I data.

REPEAT (R)

Causes a formatted field selection criterion to be repeated.

RETURN

Returns to the Primary Option Menu.

RIGHT

Positions the display to the next criteria. Synonym for FORWARD.

SHOW (SH)

Displays LEVEL, NUMBER, FORMAT, OFFSET, or PICTURE information for the selection fields.

SYNC

Controls the display of the SYNC term for fields in a COBOL record layout.

UP

Scrolls up.

USE

Specifies another record layout for the current formatted selection criteria.

VIEW (V)

Displays the View Criteria screen which is a keyword summary of the current settings for options and formatted selection criteria. See also View MVS Criteria.

ZERO (Z)

Controls the display of leading zeros in the numeric

View MVS Selection Criteria

The following figure appears when you enter the VIEW command when defining Selection Criteria for MVS files.

The following figure summarizes the current selection criteria. It displays selection criteria option settings and formatted selection criteria sets on a scrollable display. Use the VIEW primary command on any selection criteria screen to display this screen. Use the END command (PF3) to return to the previous screen.

View MVS Criteria

 File-Aid/RDX --------------- View Criteria ----------------- Row 1 to 19 of 19
 Command ===> END                                              SCROLL ===> PAGE
 Use END to exit View Display                                                   
                                                                               
 ******************************* TOP OF CRITERIA *****************************  
 DEFINE BLOCKS=SELECTION,                                                       
                                                                               
        LAYOUT_DSNAME=TSOID01.FRSAMP.LAYOUTS,                                  
        LAYOUT_MBRNAME=ORDERTAB,                                                
                                                                               
        INITIAL_SKIP=0,                                                         
        THEN_SELECT=1,                                                         
        THEN_SKIP=0,                                                            
                                                                              
        MAXIMUM_TO_SEARCH=ALL,                                                  
        MAXIMUM_TO_SELECT=ALL                                                   
                                                                              
 SELECT SET=1,LAYOUT=PROD001-ORDER-TABLE                                        
  IF                                                                            
        FIELD_NAME=CUST-NUM,                                                    
        POSITION=7,LENGTH=6,OPERATOR=EQ,                                        
        TYPE=T,VALUE=CW3375                                                     
                                                                               
 ******************************* END OF CRITERIA **************************** 

To exit the View Criteria screen:

In this field…

Do the following:

Command

Type END

Press Enter

File-AID/RDX returns to the Selection Criteria Menu screen.

To exit the Selection Criteria Menu screen:

In this field…

Do the following:

Option

Type END

Press Enter

File-AID/RDX displays to the EDIT - File-AID/RDX Generated JCL screen (remember, you entered the Edit JCL primary command on the Extract - MVS Driving Object screen.

Related topics

Primary-commands-description

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*