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.

File-AID/Data Solutions product configuration

Overview

File-AID/Data Solutions is an interactive software product that allows you to use automated and repeatable processes to update information in your data files.

File-AID/Data Solutions’ date analysis feature simplifies the identification of date fields. Its formatted field exits enable you to create consistent and reliable test data for a variety of business functions. The data analysis field exit analyzes the data in a field and reports whether the data is valid or invalid.

Configuration Procedures

Sample PARMLIB member FADA00 in hlq.SXVJSAMP provides the core parameters required for File-AID/Data Solutions and should be used as a skeleton for parameters for your particular installation.

Important

Sample PARMLIB member FADAALL includes all available parameters. If your site requires non-core parameters, you only need to copy those individual parameters to your site PARMLIB member that require non-default parameter values.

Edit the parameter values to configure File-AID/Data Solutions to your site’s desired settings.

The variables are divided into groups. The valid groups are:

Groups

Descriptions

Batch:

Default values used to submit batch jobs and create data sets. Batch Parameters provides a listing of these variables. For more information, see Getting started with File-AID/Batch about the batch features of File-AID.

Environment 1:

Default values used to modify File-AID option. Environment 1 provides a listing of these variables.

Environment 2:

Default values used to modify the File-AID online environment variables. Environment 2  provides a listing of these variables.

Environment 3:

Variables used to activate a restricted fix that resolves a specific issue or concern. Environment 3  provides a listing of these variables.

File-AID/Data Solutions Core Parameters (FADA00) 

Important

There are no CORE specific parameters for this product.

File-AID/Data Solutions Additional Parameters (FADAALL)

Important

Review the ALL PARMLIB member to see which of the additional parameters require site specific changes. You only need to copy those individual parameters to your site PARMLIB member that require non-default parameter values.

PRINT_UPPERCASE_OR_MIXED

Description: Character set. Max. length 1.
(0=Upper Case,1=Upper/Lower/Kana)
0 (F0) Upper case only.
1 (F1) Upper case and lower case.
To change or add special characters, see the Character Translation Table option at the end of this table.

Batch Override Displacement:1A

Default: 1 (F1)

Batch Parameters

The following parameters are batch processing parameters.

MAX_RECORDS_TO_PRINT

Description: Record print default. Max. length 4.
(0-9999) Default=250
The number of records that File-AID prints if no form of output control is placed on functions that cause printing on SYSLIST. The value can be any number from 0 through 9999. When all zeros (F0F0F0F0) are entered, all records in the file are printed.

Batch Override Displacement: 0F

Default: 0250 (F0F2F5F0)

BATCH_BUFFER_SPACE

Description: Batch buffer space. Max. length 2.
(5-99)
Controls the amount of memory assigned for buffer space. The number of buffers assigned is calculated by multiplying this option number by 10 kB, then dividing the total by the block size of the data set.
The minimum allowed entry is 05 (50 kB) and the maximum is 99 (990 kB). The default for this option is 6 which is multiplied by 10 kB = 60 kB. Accordingly, the default for File-AID/Batch buffers is 60kB divided by the block size of the data set.
This space is assigned to each open data set. This option can be overridden by coding the BUFNO parameter in the DCB entry on DD statements.
The REGION size required at File-AID/Batch execution time may need to be increased depending on the value of BATCH_BUFFER_SPACE and BUFNO coded in the JCL.
For VSAM data sets, this option times 10 kB becomes the buffer space option. It is then used to dynamically compute the number of buffers to assign for VSAM processing. In the case of the USER function where more than two data sets are open at the same time, memory may be a problem if a region parameter is not entered on the EXEC or JOB card.
The minimum number of buffers File-AID allows is five for MVS and three for non-MVS to allow support for chained scheduling.

Batch Override Displacement: 15

Default: 06 (F0F6)

TSO_BUFFER_SPACE

Description: TSO buffer space. Max. length 2.
(5-99)
Controls the amount of storage used for buffers by each open data set when File-AID/Data Solutions is executed in a TSO environment. The description for Batch Buffer Space also applies to this option.

Batch Override Displacement: 17

Default: 06 (F0F6)

NO_RECORDS_COPIED_RETURN_CODE

Description: No records copied return code. Max. length 2.
(00-99)
Specifies the return code that File-AID/Data Solutions is to issue when records are not selected for copying to any output data set in a copy operation. The value 08 reflects the current return code issued. Any number from 00 (issue no return code) through 99 is valid. File-AID/Data Solutions always reflects the highest return code issued during an execution.

Batch Override Displacement: 2C

Default: 08 (F0F8)

PAD_CHAR_WHEN_REC_LENGTH_CHANGES_IN_COPY

Description: Pad character. Max. length 2.
(hexadecimal value)
Sets a default for File-AID/Data Solutions to use to pad when the record length changes during COPY processing.

Batch Override Displacement: 2F

Default: 00

SUPPORT_SYSTEM_DETERMINED_BLOCK_SIZE

Description: Support system-determined blocksize. (Blocksize=0). Max. length 1.
(Y,N,I)
If your operating system supports this installation option, it allows you to have your system determine the blocksize of new output PS and PO data sets allocated for File-AID/Data Solutions if the RECFM is not undefined (=U). The following settings are valid:
Y (E8) Enables your system to determine the blocksize when the blocksize is not coded or BLKSIZE=0 is coded.
I (C9) Uses the IBM process for determining blocksize. File-AID/Data Solutions allows the system to determine the blocksize when BLKSIZE=0 is coded. File-AID uses the blocksize of the input data set when a blocksize is not coded.
N (D5) Disables this support. File-AID/Data Solutions uses the blocksize of the input data set when a blocksize is not coded or BLKSIZE=0 is coded..

Important

Note for option I and N: If the output blocksize is not coded, then the output LRECL must be equal to the input LRECL in order for File-AID/Data Solutions to use the blocksize of the input data set. If the LRECLs are not equal, then File-AID assigns the output LRECL as the output blocksize.

Important

  1. File-AID/Data Solutions ignores the setting of this Product option unless you have IBM’s Data Facility Product (DFP) Version 3 Release 1 or greater (for DASD), DFP Version 3 Release 2 (for tape) or IBM’s DFSMS installed.
  2. Modifying this option may change default allocations of existing batch jobs.

Batch Override Displacement: 38

Default: N (D5)

REPLACE_LIKE_MEMBERS

Description: PDS replace like members. Max. length 1.
(Y=YES,N=NO)
Yes (E8), replaces like-named members in a PDS. Change to No (D5), do not replace like-named members.
This option can be overridden at execution time with the RLM parameter.

Batch Override Displacement: 3F

Default: Y (E8)

MAINTAIN_PDS_STATISTICS

Description: Maintain PDS statistics. Max. length 1.
(Y=YES,N=NO,A=ADD)
No (D5) Do not maintain PDS statistics.
Yes (E8) Maintain PDS statistics.
Add (C1) Maintain PDS statistics, and add when they previously did not exist.
This option can be overridden at execution time with the PDSSTAT parameter.

Batch Override Displacement: 41

Default: N (D5)

Important

Common parameter COMMON_PDS_STATISTICS deprecates and overrides the MAINTAIN_PDS_STATISTICS parameter, unless the COMMON_PDS_STATISTICS=D (default) value is specified.

Modify Batch Options at Execution

The OPT parameter in the PARM field is used to override or change batch options with displacements of 0F through 43. These HEX displacements correspond to OPT parameter positions 1 through 53.

The OPT parameter also includes the following common parameters with their displacement values in the following table. Refer to File-AID-Common-Components-Additional-Parameters-FACMALL for their descriptions.

Common BATCH Product Option Variables Displacements

Variable Name

Displacement

1D

1E

3B

File-AID/Data Solutions processes the option fields as one contiguous data field, so all options to the left of the option being changed must be specified as well. The data entered in the OPT parameter overlays the installation option area from left to right.

Example

Change the Batch buffer space option from the default value 06 to 12.

// EXEC PGM=UDASOLUT,PARM=’OPT=02501012’


Important

DASOLUTN is an alias of UDASOLUT.

Environment 1

The following parameters are the Environment 1 parameters.

IO_EXIT_USAGE

Description: User-written I/O exit. Max. length 8.
(YES,NO,EXITNAME)
This option is used in conjunction with user-written I/O exits (see also I/O Exit). Valid entries include:
NO Do not display I/O exit fields on the File-AID/Data Solutions panels.
YES Display fields on the panels enabling the user to enter the name of an I/O exit program module.
EXITNAME Display fields on the panels with a prefilled name of an I/O exit program module.

Default: NO

TEMPORARY_DSN_FORMAT

Description: Customizes the temporary DSN's used by File-AID/Data Solutions. Max. length 8.
The variables TEMPORARY_DSN_FORMAT , TEMPORARY_DSN_LITERAL , and TEMPORARY_DSN_SUFFIX allow you to customize the temporary data set name used by File-AID/Data Solutions.
TEMPORARY_DSN_FORMAT is a six-character string defining the node sequence of the temporary data set name. Each character represents the contents of a node as follows:
U - Your TSO prefix, or user ID when a prefix is not set.
L - Literal, up to eight characters, defined by the TEMPORARY_DSN_LITERAL variable. The default is FILEAID.
I - Two-character identifier that is assigned by File-AID to identify the type of temporary data set. This character is required.
D - Date in Dyyddd (Julian) format.
T - Time in Thhmmss format.
S - Suffix, up to eight characters, defined by the TEMPORARY_DSN_SUFFIX variable. The defaults is blanks.
X - TSO user ID.

Important

U and X are not mutually exclusive. However, if both are coded and no TSO prefix is active/specified, the resulting DSN will contain user ID twice.
You may rearrange the order of the nodes.

Important

It is possible to specify these variables so that the temporary data set name exceeds 44 characters. If this happens, File-AID detects it on startup, stops, and issues the message: MAX data set name exceeds 44 characters.

Example

File-AID names a compare criteria data set created according to the TEMPORARY_DSN_FORMAT  variable default, ULIDTS, as follows: userid.FILEAID.CC.Dyyddd.Thhmmss.

If you change the TEMPORARY_DSN_FORMAT  variable to USILTD, TEMPORARY_DSN_LITERAL  to FA, and TEMPORARY_DSN_SUFFIX  to TEMP, File-AID names the same compare criteria data set: userid.TEMP.CC.FA.Thhmmss.Dyyddd.

Default: ULIDTS

TEMPORARY_DSN_LITERAL

Description: String for the literal node of a temporary data set. Max. length 8.
TEMPORARY_DSN_FORMAT specifies a string, up to eight characters, for the LITERAL node of the temporary data set name. See TEMPORARY_DSN_FORMAT .

Default: DASOLUTN

TEMPORARY_DSN_SUFFIX

Description: String for the suffix node of a temp data set. Max. length 8.
TEMPORARY_DSN_SUFFIX specifies a string, up to eight characters, for the SUFFIX node of the temporary data set name. See TEMPORARY_DSN_FORMAT .

Default: none

Environment 2

The following parameters are the Environment 2 parameters.

ABR_IN_USE

Description: ABR allocation. Max. length 1.
(0,1)
0 - ABR is not used.
1 - If your installation uses Innovation Data Processing, Inc.’s Automatic Backup and Recovery (ABR) for archival and retrieval, allocation of data sets will be forced when an attempt to find them on a volume fails.

Default: 0

DATASET_RESERVE_OR_ENQUEUE

Description: Data set Reserve/Enqueue. Max. length 1.
(Valid values used to be: 0=Reserve,2=Enqueue)
0 - Always do reserves.
2 - Always do enqueues. 2 is intended for sites that do not have shared DASD or have software packages such as MIM (Multi-Image Manager) or GRS.

Important

This parameter is ignored.

It is always processed as though the value is a 2.

LOG_FA_FUNCTIONS_TO_ISPF_LOG

Description: ISPF log data set access. Max. length 1.
(0,1)
All File-AID functions may be logged to the ISPF log data set. When this option is enabled (1), all functions are logged including data set destructs. In addition, interactive functions are logged.
0 - File-AID/Data Solutions functions ARE NOT logged to the ISPF log data set.
1 - All File-AID/Data Solutions functions are logged including data set destructs. In addition, interactive functions are logged.

Default: 0

BATCH_REGION_SIZE

Description: Region size (in M) for creation of batch JCL. Max. length 2.
(0,8-99)
Default REGION size used within generated BATCH jobs.

Default: 08

Environment 3

The following parameters are the Environment 3 parameters.

ALLOW_UPDATE_IN_PLACE_KEY_ENCRYPT

Description: Allow update in place key ENCRYPT. Max. length 1.
(Y=YES,N=NO)
N - Do not allow update in place key ENCRYPT.
Y - Allow update in place key ENCRYPT.

Default: N

Related topics

BMC Compuware File-AID/Data Solutions

 

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