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.

BMP Processing Options


BMP_PROCESSING_ALLOWED

Description: BMP Indicator. Max. length 1.
Valid entries are N (No) or Y (Yes).
Specify whether BMP processing is allowed within the environment.

Default: Y

BMP_USER_MAX_INACTIVITY_TIME

Description: Max time a BMP user can be in a wait state (no activity). Max. length 2.
Specify the maximum time a BMP user can be in a wait state (no activity from the terminal). When exceeded, the BMP task is ended. We recommend that the time should be less than the TSO wait time limit to avoid a timeout (522 ABEND) while the BMP region is active. Valid entries are in the range from 0 to 59 minutes. If BMP_USER_MAX_INACTIVITY_TIME is set to 0, no File-AID for IMS time out occurs.

Default: 30

DYNAMIC_PSB_PREFIX_FOR_BMP_PROCESSING

Description: PSB prefix used of dynamic PSB BMP processing. Max. length 5.
Specify the ACBNAME prefix, which is any one- to five-character string to be used to construct the ACBNAMEs. The ACBNAMEs that are used contain the ACBNAME prefix followed by a three digit number (000-999). For example:
FAIMS000, FAIMS001, …, FAIMS(nnn-1)where FAIMS is the prefix and nnn is the number of ACBNAMEs.
It is recommended that an ACB prefix that is unique for each environment be added.

Default: FAIMS

NUMBER_SIMULTANEOUS_DYNAMIC_BMP_USERS

Description: Number of simultaneous dynamic PSB BMP sessions. Max. length 3.
Because an ACBNAME is required for each concurrent BMP user of File-AID for IMS, specify a number high enough to satisfy all simultaneous BMP users.

Default: 10

Required: yes

DATASET_FOR_DYNAMIC_ACBS

Description: ACBLIB to contain dynamic PSB ACBs. Max. length 44.
Specify the DOPT ACB library dataset name (DOPT.ACBLIB) to contain File-AID for IMS’ dynamically created ACBs. This is a required library that you may need to allocate yourself. The attributes of the data set should match those of the static ACBLIB. After creating the data set, ensure that it is concatenated last on the IMSACBA and IMSACBB DD cards of the JCL that is used to start the IMS control region.
This data set can be shared with other products, but to greatly reduce maintenance on this library, we recommend that it be assigned exclusively to File-AID for IMS. This library is used to dynamically create any ACBs that are required by the users.

Default: blank (no default value)

Required: only if ALLOWED_PSB_PROCESSING_TYPE= A or D and BMP_PROCESSING_ALLOWED=Y

EMPTY_ACBDOPT_DATASET_BEFORE_EACH_USE

Description: Empty ACBDOPT DSN before each use. Max. length 1.
Valid entries are Y (Yes) or N (No).
Specify whether to have File-AID for IMS automatically reset (empty) the DOPT ACBLIB data set. Specifying Y causes the directory of the data set to be reset to an empty state prior to writing out the new ACB. Specify Y only if File-AID has exclusive use of that data set.
You should not provide secondary extents. If an ACBGEN causes a secondary extent to be obtained, IMS is not aware of the secondary extent and will get an IO error when attempting to read the member.

Default: Y

 

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