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.

Request file member list

The Request File Member List Screen is displayed when you:

  • Select Option 2, Extract, from the File-AID/RDX Primary Option Menu and your profile set it as the first extract panel;
    or
  • Enter the REQuest command in an extract panel

Important

File-AID/RDX will also display the Request File Member List Screen, when your profile lists the Extract Reference List as the first extract panel, but the list is empty and your profile includes an extract request file.

This screen displays the member list of the specified request file or an extract criteria file created with File-AID/RDX prior to Release 3.0. Use one of the line commands to select a member for your extract request.

Request File Member List Screen

 File-AID/RDX ------------  Request File Member List  --------- Row 1 to 8 of 8
 Command ===>                                                      Scroll ===> CSR
 
 Primary commands: New, Find, Size, REFerence
    Line commands: G = Go C = Change Selection & Go S = Select M = Modify SSID
                   D = Delete R = Rename

 Request File ===> FRSAMP.EXTCRIT                      

    Member    Description                                         Changed
    --------  --------------------------------------------------  ----------
 _  DB2VSAM   db2 to vsam extract                                 2004/06/01
 _  MCUST0DB  MVS - TSOID01.CUSTOMER.FILE                         2004/08/13
 _  MIKE1     Member List                                         2004/05/10  
 _  NODB2     mcust with db2 deleted                              2004/01/25  
 _  ORDER     DB2 - LOCATION.TSOID01.CUSTOMER                     2004/08/30
 _  PART1     Member List                                         2003/02/11
 _  SELCUST   test select customer                                2002/01/28
 _  TESTA     test saving the criteria                            2001/04/12
 ******************************* Bottom of data ********************************

Request File

The request file name comes from your current profile. If your profile does not include a request file, File-AID/RDX will prompt for one. Enter a new file name to change to a different saved request file or extract criteria file and File-AID/RDX will display its member list.

Clear the field and File-AID/RDX displays the Extract Reference List.

The lower part of the screen displays a listing of the file’s members.

Member

Member name in the request file or extract criteria file. The member names are displayed in alphabetical order.

Description

Text that was entered in the Description field when the extract request was created. If you left the field blank, File-AID/RDX sets the description to the driving object type and name.

Changed

Date when the member was last saved.

Line Commands

The following File-AID/RDX-specific line commands are valid on this screen:

Important

If the extract request has Checkpoint/Resumption Enabled, the Checkpoint Confirmation window (Checkpoint/Resumption Confirmation Windows) asks whether to continue the extract request before submitting when issuing either the C, G, or V line commands.

C (Change selection criteria & Go)

Repeat this extract request with new selection criteria for the driving object. File-AID/RDX then displays the appropriate Object Selection Criteria screen for the driving object, either Object Selection Criteria - Selective Columns, Db2 Object Selection Criteria, or Selection Criteria Menu. After you specify the new selection criteria, File-AID/RDX will submit the extract request.

D (Delete)

Delete this member from the request file. Displays the Delete Confirmation window (see the following figure).

Delete Confirmation window

                            Delete Confirmation
  COMMAND ===>                                                                
                                                                              
   Request File ....: ‘TSOID01.FRSAMP.EXTCRIT’                                 
                                                                             
   Member to be Deleted: TESTA                                                 
                                                                              
                                                                              
   ENTER to confirm delete                                                     
     END to return to Request File Member List  

G (Go)

Submits this extract request without any changes.

M (Modify)

Selects this extract request, displays the Modify Extract Request panel for you to change or “clone” an existing extract request. See also Modify Extract Request.

R (Rename)

Rename the request member. The Rename Confirmation window (see the following figure) allows you to enter a new name for the request file member.

Rename Confirmation window

image2021-10-22_19-13-35.png

S (Select)

Selects this extract request and displays the Extract Menu prefilled with all the information from this request. See also Extract Menu.

V (View JCL)

Displays the JCL for this extract request. File-AID/RDX shows the ISPF/PDF EDIT Screen—File-AID/RDX-generated JCL panel where you review and modify the extract JCL.

Primary Commands

The following File-AID/RDX-specific primary commands are valid on this screen:

FIND (F)

Searches the member list for the specified string and scrolls the list to display the first matching entry at the top of the displayed entries. Use RFind to repeat the search.

NEW (N)

Starts a new extract request based on your current profile. File-AID/RDX displays either the DB2 or MVS Driving Object screen as set in your profile (see Extract - Db2 Driving Object or Extract - MVS Driving Object).

You can also include one of the optional parameters, Db2 or MVS, to display the respective Driving Object screen.

REFERENCE (REF)

Displays your Extract Reference List panel. For more information, see Extract Reference List.

SIZE (S)

Increases the scrollable area to display more entries at a time by hiding some of the screen header lines. See the following figure for an example. Size is a toggle switch so enter Size again to return to the original format.

Request File Member List - Size Screen

 File-AID/RDX ------------  Request File Member List  --------- Row 1 to 8 of 8
 Command ===>                                                  Scroll ===> CSR
    Member    Description                                         Changed
 _  DB2VSAM   db2 to vsam extract                                 2001/06/01
 _  MCUST0DB  MVS - TSOID01.CUSTOMER.FILE                         2001/08/13
 _  MIKE1     Member List                                         2002/05/10  
 _  NODB2     mcust with db2 deleted                              2001/01/25  
 _  ORDER     DB2 - LOCATION.TSOID01.CUSTOMER                     2001/08/30
 _  PART1     Member List                                         2002/02/11
 _  SELCUST   test select customer                                1999/01/28
 _  TESTA     test saving the criteria                            2001/04/12
 ******************************* Bottom of data ********************************

Extract requests from releases prior to release 4.0

File-AID/RDX accepts extract requests created with an earlier release of File-AID/RDX than Release 4.0.

When selecting such a request with the S or M line command, File-AID/RDX will convert the request to the new Release 4.0 format. For example, File-AID/RDX will set the navigation and sampling controls to approximate the old extract method (OPTIMUM, STANDARD, MOST, or DETAILED). However, the extract results may differ as an exact conversion may not be possible.

Conversion of Old Extract Methods

Navigation Controls

OPTIMUM

MOST

STANDARD

DETAILED1

Direct

Y

Y

Y

*

Parents

Y

Y

Y

*

Siblings

N

Y

N

*

Indirect

N

Y

Y

*

  • 1: For Detailed, the controls are converted as specified per individ­ual relationship

Other new extract features will default to the values specified in the current profile or current session.

In the Extract Menu review the resulting conversion before submitting the extract request. Pay particular attention to Sampling Controls like:

  • Maximum Rows from an object,
  • Dependents-per-parent
  • Extract every nth row for Db2 objects

and Navigation Control settings for:

  • Sibling paths
  • Indirect Dependent paths
  • Many to many relationships

Sampling Controls have been moved from the Selection Criteria to the Extract Scope Object View and Relationship Sampling Criteria panels.

Important

When submitting a pre-Release 4.0 request directly for batch execution, for example with the G (Go) or C (Change and Go) line command (here or here), the request will be converted and executed using a temporary request file.

Related topics

Invoking-File-AID-RDX

 

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