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.

Extract reference list to extract request


The Extract Reference List screen shown in the following figure 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 REFERENCE command on an “Extract Menu” panel

Use this screen to select an extract request from the list or start a new extract request. File-AID/RDX adds an extract request to the list whenever a request is saved from the Extract Menu. Extract requests that originate from the “Single Panel Extract” function are not saved to a request file and thus not included in the Extract Reference List.

Important

If your reference list is empty, File-AID/RDX will display the Request File Member List screen, listing the members of the request file specified in your profile, or if none is in your profile, display either the Db2 Driving Object or MVS Driving Object screen so you can create a new extract request.
The reference list is stored in your personal USER profile. If your USER profile file (‘userid.midlevlqualifier.PROFILE’) does not exist, File-AID/RDX will create your USER profile when you are saving an extract or load request.

You can also create a new extract request with the NEW command, or open a saved extract request file with the REQUEST command. Use the REQUEST command to open extract criteria files created with File-AID/RDX prior to Release 3.0.

For how to set the maximum number of list entries for the reference list, see Option G—Global User Defaults.

You may specify multiple line commands at a time. All line commands are processed before any primary commands. When processing multiple commands File-AID/RDX displays a message like “Processing line command 2 of 4” whenever it starts processing the next line command after the first.

Extract Reference List

 File-AID/RDX -------------  Extract Reference List  ------- Row  1 to  6 of  6
 Command ===>                                                  Scroll ===> CSR
                                                          
  Primary commands: New, Find, Size, Detail, REQuest
     Line commands: G = Go   C = Change Selection & Go S = Select M = Modify
                    I = Info D = Delete from list      L = Lock   U = Unlock

   Request  Extract File Name                                     RT L YY/MM/DD
   -------- ----------------------------------------------------- -- - --------
 _ MVSSAMP  TSOID01.FRSAMP.REQUEST                                E    11/01/03
 _ SAMPMIN  TSOID01.FRSAMP.CUST.EXTRACT                           E    01/02/18
 _ DIEBLDX  TSOID01.FRSAMP.CUST.EXTRACT.DB2VSAM                   E    01/02/04
 _          TSOID01.FRSAMP.EXTRACT                                EL L 01/02/01
 _ DIEBLD1  TSOID01.FRSAMP.EXTRACT                                E    01/01/31
 _ DIEBLD   TSOID01.FRSAMP.CUST.EXTRACT.NODB2(EXTCUST)            EL L 00/12/24
 _ MVORDR   TSOID01.FRSAMP.EXTRACT.ORDER                          E    99/08/24
 ******************************* Bottom of data ********************************

The lower part of the screen displays a listing of your recently referenced extract requests. Use one of the line commands to either resubmit one of the extract requests or model a new request after it.

Request

Name of the extract request (member name in the saved extract request file or extract criteria file). A blank entry means the request was saved to a sequential file.

Extract File Name

Name of the file containing the extracted data. If saved to a PDS the member name is displayed in parentheses.

RT

Request Type. Identifies the extract request type:

E

Extract only request.

EL

Extract and Continue with Load request.

L

Locked Entry. Identifies whether the request is locked in the reference list or whether it is allowed to roll off.

blank

not protected from roll over.

L

Locked in reference list; entry will not roll off the list.

YY/MM/DD

Date when the extract request was last saved or executed. The list entries are ordered with the most recent date placed on top of the list.

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 (see 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 ColumnsDb2 Object Selection Criteria, or Selection Criteria Menu. After you specify the new selection criteria, File-AID/RDX will submit the extract request.

D (Delete from list)

Removes this extract request from the extract reference list, but does not delete the member from the extract request file itself.

G (Go)

Submits this extract request without any changes.

I (Info)

Displays the Request Details screen, which provides more comprehensive information about the extract request. See the following figure for an example.

Request Details

File-AID/RDX ----------------  Request Details  -------------------------------
 Command ===>

 Request Information:                                           
   Request File Name  . : TSOID01.FRSAMP.REQUEST                  
   Member Name  . . . . : MVSSAMP                                 
   Request Type . . . . : EXTRACT                                 
   Description  . . . . : MVS                         
   Reference Date . . . : 2011/01/03     Reference Time: 00:00:07
                                                                
 Driving Object Information:                                    
   SSID . . . . . . . . :                                     
   Name . . . . . . . . : MVS - TSOID01.FRSAMP.ORDERTAB            
                                                                
 Extract Information:                                           
   Extract File Name  . : TSOID01.FRSAMP.OUT                      
   Summary File Name  . : TSOID01.FRSAMP.TAPECNTL                 
   Disguise Control File:                  
   Repository Name:                  
   Project Name:                  
   Extract Date . . . . : 2011/01/03     Extract Time  : 12:00:01
                                                                
 Relationship Information:                                      
   File Name  . . . . . : TSOID01.FRSAMP.RELATION 

L (Lock)

Protects this entry from rolling off the extract reference list.

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.

S (Select)

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

Important

If your profile specifies not to display the Extract Menu, File-AID/RDX will submit the request immediately.

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.

U (Unlock)

Does not protect this entry from rolling off the extract reference list.

Primary Commands

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

DETAIL (D)

Expands the one-line display for each request into a two-line display. The additional line shows the request description. See the following figure as an example. Detail is a toggle switch so enter Detail again to return to the original format.

Extract Reference List - DETAIL Screen

 File-AID/RDX -------------  Extract Reference List  --------- Row 1 to 6 of 6
 Command ===>                                                   Scroll ===> CSR
                                                          
  Primary commands: New, Find, Size, Detail, REQuest
     Line commands: G = Go   C = Change Selection & Go S = Select M = Modify
                    I = Info D = Delete from list      L = Lock   U = Unlock

   Request  Extract File Name                                     RT L YY/MM/DD
   -------- ----------------------------------------------------- -- - --------
 _ MVSSAMP  TSOID01.FRSAMP.EXTRACT                                E    11/01/03
            Description:  MVS
 _ SAMPMIN  TSOID01.FRSAMP.CUST.EXTRACT                           E    04/02/18
            Description:  This extract uses Acct number
 _ DIEBLDX  TSOID01.FRSAMP.CUST.EXTRACT.DB2VSAM                   E    04/02/04
            Description:  DB2-FR.PRODUCT_CONTRACT  
 _          TSOID01.FRSAMP.EXTRACT                                EL L 04/02/01
            Description:  This extract selects region 10
 _ DIEBLD1  TSOID01.FRSAMP.EXTRACT                                E    04/01/31
            Description:  MVS-FRSAMP.CUSTOMER
 _ MVORDR   TSOID01.FRSAMP.EXTRACT.ORDER                          E    99/08/24
            Description:  MVS-FRSAMP.ORDER
 ******************************* Bottom of data ********************************

FIND (F)

Searches the 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.

Find looks for matches in the request detail information for each list entry. When a match is found and is not visible in the displayed row, use the I (info) line command to display the detail information.

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.

REQUEST (REQ)

Opens a saved extract request file. You also use the REQuest command to open extract criteria files created with File-AID/RDX prior to Release 3.0. For more information, see Extract - Db2 Driving Object.

File-AID/RDX opens the request file specified in your current profile or prompts for the file name when none is in your profile.

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.

Extract Reference List - Size Screen

 File-AID/RDX -------------  Extract Reference List  --------- Row 1 to 6 of 6
 Command ===>                                                   SCROLL ===> CSR
   Request  Extract File Name                                     RT L YY/MM/DD
 _ MVSSAMP  TSOID01.FRSAMP.REQUEST                                E    11/01/03
 _ SAMPMIN  TSOID01.FRSAMP.CUST.EXTRACT                           E    04/02/18
 _ DIEBLDX  TSOID01.FRSAMP.CUST.EXTRACT.DB2VSAM                   E    04/02/04
 _          TSOID01.FRSAMP.EXTRACT                                EL L 04/02/01
 _ DIEBLD1  TSOID01.FRSAMP.EXTRACT                                E    04/01/31
 _ DIEBLD   TSOID01.FRSAMP.CUST.EXTRACT.NODB2(EXTCUST)            EL L 03/12/24
 _ MVORDR   TSOID01.FRSAMP.EXTRACT.ORDEER                         E    03/08/24
 ****************************** Bottom of data ********************************

Related topics

 

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