TAA Tools
TAA Productivity Tools - Release Notes
The TAA Productivity Tools are updated periodically for new tools,
enhancements, and fixes. New versions are shipped a few times per
year.

This document combines the most recent refresh notes that were
previously in separate documents for new tools, enhanced tools, fixes,
and incompatibilities. The document is organized by refresh with the
most recent refresh listed first.

The complete set of release notes can be found on https://taatool.com.

2020-04-15 (R71)

Refresh 71 (April 15, 2020) is for IBM i 7.2, 7.3, and 7.4.

No further refreshes will be made for IBM i 7.1. However, fixes to 7.1
tools will continue to be supplied on an "as needed" basis until April
30, 2021.

New Tools

-   CVTACCPTH

    The Convert Access Path command produces an outfile of physical
    and logical files which have a 4 GB max access path limit. The
    outfile can be checked for files which are approaching their 4 GB
    limit. Use of this tool could prevent applications to fail if the
    4 GB limit is surpassed.

-   CVTCERT

    The Convert Certificates command produces an outfile of
    information from server or certificate authority certificates on
    your system. Most notably, certificate expiration dates are
    output, giving administrators an easy way of checking which
    certificates need to be renewed before they expire.

Enhancements

-   Install

    The installation procedure now has the capability of adding new
    keys to application values found in TAASECURE. This will allow
    future tools to add new capabilities using application values
    without adding entirely new APPVAL structures in that library.

-   CHGOWNOBJ

    The Change Owned Objects command has been enhanced to include two
    new parameters: ACTION and ESCAPE. ACTION(*CHECK) allow you to see
    what would be changed if ACTION(*CHANGE) is used. *CHANGE is the
    default. ESCAPE(*YES) will prevent the use of any profile
    beginning with Q. This is to prevent the wholesale assignment of
    ownership from system-supplied profile. *YES is the default. This
    introduces an incompatibility.

-   CVTOBJLCK

    The Convert Object Lock command converts object locks to the
    OBJLCKP data base file with one record per lock. This allows you
    to determine who has the lock within a program. A field was added
    to show the current user profile holding the lock.

-   CVTOUTQ

    Convert Output Queue uses a system API to find the contents of an
    output queue. Normally this system API will submit auxiliary jobs
    to perform an ansynchronous listing of the queue contents. This
    makes the tool more responsive. In some cases this submission of
    auxiliary jobs is not desirable; for example, when the subsystem
    in which this tool runs is near its maximum number of jobs. A new
    AUXJOB keyword has been added to the command to suppress these
    jobs and perform the listing synchronously.

-   MTNJRN

    A new SEQOPT keyword was added to Maintain Journal so that the
    sequence numbers in the journal receivers can be reset during
    MTNJRN processing. The default is to continue the sequence numbers
    as it had been doing.

-   RTVMTHDAT / RTVSOMDAT

    These two commands allow retrieval of dates based on specified
    criteria. RTVMTHDAT and RTVSOMDAT commands have been enhanced to
    support the *NEXT value for MONTH and YEAR parameters.

-   SCNALLSRC2

    Scan All Source 2 will scan for up to 20 arguments in source files
    in one or more libraries. SCNALLSRC2 was enhanced with a FILE
    parameter, allowing the search to be narrowed to named source
    files, such as QCLSRC, QRPGLE, etc.

-   SECOFR2

    The SECOFR2 menu entry for CPYUSRPRF2 now allows the prompt for
    this command to be tailored so that the new PWDEXP and CHGOWN
    parameters can be masked. See the documentation for SECOFR2 for
    more information.

-   WRKVTP

    Work with Virtual Tape allows you to review and control the
    virtual tape devices created by CRTVTP. WRKVTP usage of available
    resources was improved by refreshing the available resource list
    before executing F8 = Avail Resources. Also, F9 command text was
    improved to indicate that either a 'Not detected' resource or a
    New resource will be returned. `

Fixes

-   ADDJOBSCD2

    The Add Job Scheduler 2 command is used to add multiple job
    scheduler entries from a database file. A quoted entry would cause
    problems for subsequent entries found in the file. This has been
    fixed.

-   ALCTMPMBR

    The Allocated Temporary Member tool is used internally by several
    other tools. In extremely rare circumstances this tool would fail
    and the tool using it would report the failure. It would have to
    be the first tool executed after midnight on a given day. This has
    been fixed. This initially showed up occuring in CVTQHST2.

-   CPYGENSRC

    The Copy Generic Source command options for the source file lists
    (SRC1, SRC2, and *SRC3) were not working. The source lists are now
    read and processed correctly.

-   CVTLIBCNT

    Convert Library Count creates an outfile with one record
    summarizing the objects in each library requested. CVTLIBCNT was
    fixed to bypass libraries that are too large to process in the
    user space. When CVTLIBCNT encounters such a library, it bypasses
    that library and then goes on to process the remaining libraries
    requested. An escape message is sent at the end in this situation.

-   CVTTAPSAVD

    This Convert Tape Save Description command would fail if the
    device was a tape library or autoloader, a specific library/label
    was named, and VOL(*MOUNTED) was specified. This has been fixed.

-   ENDJOBWOL

    End Job With Object Locks has been fixed to run in batch as well
    as interactive environments.

-   SNDINTMSG

    The Send Interactive Jobs a Message tool was failing if the caller
    did not have explicit authority to read the application value used
    to control its use. This application value should be able to be
    read by the tool for any user authorized to the tool. The
    authority issue with a helper program has been fixed.

-   RMVSUPGRP

    Remove Supplemental Group allows the removing of a supplemental
    group profile from one or more user profiles. This command was
    fixed to issue better completion messages.

-   RTVSYSPTN

    Retrieve System Partition returns information about the partitions
    on a system and the current partition. RTVSYSPTN was returning the
    opposite Capacity Capped value than it should. The tool was
    changed to return the correct value.

-   SAVRSTJOBQ

    The Save and Restore Job Queue tool supports two commands which
    support the save and restore of a job queue. CVTJOBQ2 creates an
    outfile of information about the jobs on a job queue, then
    SBMJOBQ2 command is used to read the outfile and perform a SBMJOB
    for each job found in the outfile. The outfile name was not being
    set correctly when SBMJOBQ2(*OUTFILE) was specified. This has been
    corrected.

-   SCNSPLF

    Scan Spool File scans a spool file for a string and returns a
    count of how many strings were found. A fix was added so scan
    arguments over 10 characters would be found correctly.

-   SNDTCPOUTQ

    The Send TCP Output Queue tool would fail in very rare
    circumstances due to a timtime out waiting for a port to become
    available in the SNDTCPSPLF tool. Retry logic has been added to
    minimize this possibility even further and, if the port does not
    become available, an informational message is logged rather than
    the tool failing.

Incompatibilities

-   CHGOWNOBJ

    The new ESCAPE keyword on CHGOWNOBJ defaults to *YES. Any programs
    using CHGOWNOBJ with a from user or to user beginning with a Q
    will fail with a TAA9891 exception. You can use ESCAPE(*NO) to
    suppress this exception. ## 2019-08-15 (R70)

Refresh 70 (August 15, 2019) is for IBM i 7.2, 7.3, and 7.4.

No further refreshes will be made for IBM i 7.1. However, fixes to 7.1
tools will continue to be supplied on an "as needed" basis until April
30, 2021.

New Tools

-   CMPENVVAR

    The new Compare Environment Variables command allows a comparison
    of environment variables between two systems or two versions
    converted from the same system. A listing is printed noting the
    differences between the two ENVVAR files being compared.

-   CVTENVVAR

    The new Convert Environment Variables command converts job and
    system environment variables to an outfile. The outfile can be
    used to verify current environment variable settings, or to
    compare ENVVAR settings overtime to ensure they remain consistent
    on the system.

Enhancements

-   Support for IBM i 7.4

    A new version of the tools has been created to install and run on
    IBM i 7.4. If you upgrade your system to IBM i 7.4 you will have
    60 days in which to upgrade the tools to match the operating
    system. The 7.3 and prior versions of the tools are not supported
    on IBM i 7.4 so you are encouraged to upgrade promptly.

-   Support for multiple licenses

    The tools can now support multiple licenses on a single system.
    This makes it much easier to manage cases where the system image
    must be switched or replicated to a system with a different serial
    number. This would include cases for capacity backup (CBU),
    disaster recovery (DR), high availability (HA), or live partition
    mobility (LPM).

    Supplemental licenses can be installed in addition to the base
    license for a system. The base license is created either during
    install or with CHGTAAKEY. Its serial number must match the system
    at that time. Supplemental licenses are installed on that same
    system and can reference other serial numbers. If a license check
    fails for the base license, the supplemental licenses are checked.

    The base license resides in the TAATOOL/TAALICENSE data area.
    There can be up to 9 supplemental licenses in TAATOOL named
    TAALIC_001 through TAALIC_009. You create a supplemental license
    using the CHGTAAKEY command as follows:

        CHGTAAKEY KEY() LICNBR(1)

    This creates a supplemental license in TAALIC_001.

    When the additional system is used, the base license and
    supplemental licenses are available since they've been replicated
    or switched. The base license check will fail, but the
    supplemental license check will succeed. This will be entirely
    transparent to you.

-   Support for handling * and ? in IFS names

    The Root and QOpenSys file systems in IFS can have files and
    directories that have the * and ? characters in the names. Various
    IFS command would come across these while scanning the directory
    structure and treat these as pattern names. Several commands have
    been updated to handle these names properly - most notably DLTIFS.

    The commands now also allow for quoting arguments in the same
    manner as WRKLNK. Thus, if you don't want a pattern match you have
    to quote the designated string twice on the command line. For
    example, suppose you have the following files in your home
    directory:

        aaa.txt
        abc.txt
        abc*.txt
        abc?.txt
        abc'.txt

    Let's assume the current directory is your home directory.

    The following command lists four files.

        WRKLNK 'abc*.txt'

    But this command only lists one file.

        WRKLNK '''abc*.txt'''

    Thus, the following command would delete the four files that begin
    with abc.

        DLTIFS OBJ('.') OBJNAM('abc*.txt')

    However, as expected, this command would delete only abc*.txt.

        DLTIFS OBJ('.') OBJNAM('''abc*.txt''')

-   CHKIFSDMG

    Check IFS Damage works by saving the IFS objects to a temporary
    save file. It now provides diagnostic information in the job log
    that shows the save file size calculation in case of a CRTSAVF
    failure.

-   CPYUSRPRF2

    Copy User Profile 2 is an option on the SECOFR2 menu. It allows an
    "assistant security officer" the ability to establish a user
    profile by copying an existing one and initializing its password
    with INZPWD. CPYUSRPRF2 is now disabled if *ALLCRTCHG is specified
    in the QPWDRULES system value since the intent is to give the user
    a relatively easy password that will be immediately changed.

-   CVTQRYSTMT

    Convert Query Statement was enhanced to allow it to be used in
    batch.

-   CVTSBSD

    The Convert Subsystem Description tool was enhanced to include the
    last used date for the job queue in the SBSJBQENT outfile that is
    produced.

-   CVTSYSVAL

    Convert System Values has been enhanced to fully capture all the
    system values. Prior to this refresh some long system values were
    not being fully captured.

-   DSAOLDPRF

    We added a parameter to the DSAOLDPRF command that allows you to
    select a method for disabling old profiles. The *CHGUSRPF default
    method will disable any profile that meets the aging criteria
    including QSECOFR. The *DSAUSRPRF method will use a DSAUSRPRF
    command and can be more selective. It will never disable QSECOFR
    and other profiles can be protected as well. See the documentation
    for DSAUSRPRF for details.

-   DSPSBMJOB

    Display Submitted Jobs received several enhancements.

    1.  Job numbers can roll over. Jobs are now sorted by their entry
        date and time, not by job number so job number rollover no
        longer prevents toggling between ascending and descending
        order.

    2.  Option 8 now shows an appropriate message if the job no longer
        exists in the system.

    3.  Displaying with no jobs now allows F5=Refresh and
        F6=Ascending/Descending.

    4.  A misbehaving SPLFPGM will no longer terminate the command,
        but will halt processing of the list.

    5.  DSPSBMJOB now shows batch immediate jobs as submitted jobs.
        These jobs are usually started by the system to carry out
        asynchronous tasks for long running APIs. WRKSBMJOB does show
        these.

-   DSPSUMJOBQ

    The Display Summary of Job Queue command was enhanced by adding a
    sequence parameter to sort the outfile by ascending or descending
    order.

-   EXCCMD

    The Execute Commands command can print a list of commands that
    were executed from a source file. This listing would truncate some
    lines if they were too long. The tool now prints a longer line
    along with its change date.

-   GENRANPWD2

    The Generate Random Password 2 tool has been enhanced so that it
    now respects all the settings for QPWDRULES that could apply to
    generation without knowing the password history.

    The following QPWDRULES are now supported:

        *PWDSYSVAL
        *MAXLENnnn    *MINLENnnn
        *REQANY3      *MIXCASEn
        *CHRLMTAJC    *CHRLMTREP
        *LTRMIN       *DGTMIN      *SPCCHRMIN
        *LTRMAX       *DGTMAX      *SPCCHRMAX
        *LTRLMTAJC    *DGTLMTAJC   *SPCCHRLMTAJC
        *LTRLMTFST    *DGTLMTFST   *SPCCHRLMTFST
        *LTRLMTLST    *DGTLMTLST   *SPCCLHRMTLST

        If QPWDRULES is set to *PWDSYSVAL then the following
        system password rules are supported:

        QPWDMAXLEN - like *MAXLENnnn
        QPWDMINLEN - like *MINLENnnn
        QPWDLMTREP - like *CHRLMTAJC or *CHRLMTREP
        QPWDRQDDGT - like *DGTMINn (n is 0 or 1)
        QPWDLMTAJC - like *DGTLMTAJC
        QPWDLMTCHR - no corresponding rule in QPWDRULES
            This is only used if the password level is 0 or 1

-   PRTJRNRCV

    The Print Journal Receivers command has been enhanced by adding
    two fields to it's output - the first sequence number and volume
    ID. This allows you to identify which media volume (usually tape)
    on which the journal receiver is stored.

-   QRYUSE

    The Convert Query Statement command of the QRYUSE tool was
    enhanced to allow the tool to run in all environments, including
    batch.

-   RPLSYSVAL

    The Replace System Value tool has been enhanced to be able to set
    the QSSLCSL value if QSSLCSLCTL is set to *USRDFN. QSSLCSL was
    being skipped and had to be manually set.

    Also the exception report produced by RPLSYSVAL now has all of the
    message text associated with any errors that might be encountered
    when doing the CHGSYSVAL.

-   RTVDBR

    The Retrieve Database Relations was enhanced to show the
    additional view of dependencies of a logical file.

Fixes

-   APYUSRCHG

    Apply User Journal Changes overrides a printer file to change the
    name of the report to the name of the file whose changes were
    being applied. This was failing if changes were being applied to
    *ALL files. The override in this case now assigns APYUSRCHG to the
    name of the report.

-   CHGOBJAUT

    The Change Object Authorization would occasionally fail when used
    by the CVTWRKACT tool. This was due to an undocumented lock on the
    output file being held by a system thread in CRTDUPOBJ. The
    workaround is to wait on a lock for the object held by that thread
    and proceed when that lock is acquired.

-   CPYSPLFIFS

    The Copy Spooled File to IFS would fail when creating a PDF when
    the overflow line of the spooled file was less than 60. This has
    been corrected.

-   CVTJRNA

    The Convert Journal Attributes tool is used by several other
    tools. In very rare circumstances the tool would fail if the files
    being journaled were deleted while it was running. Monitors have
    been added to check for this condition.

-   CVTJOBACG3

    The tool was not behaving well for ENDJOB *CNTRLD if accounting
    entries were being added on a frequent basis. The check for the
    *CTRLD end is now being made more frequently.

-   CVTLIBLCK

    The Convert Library Locks tool would fail if an override existed
    for the file TAATOBJDP - the model file for the output from the
    command. This has been fixed.

-   CVTMSGQ

    The Convert Message Queue tool could fail in rare circumstances
    with an index out of range due to extremely long messages in the
    message queue.

-   DSPMSGQINQ

    The Display Message Queue Inquiries command would sometimes miss
    an inquiry message if those messages were present next to each
    other without replies in the message queue. This has been fixed.

-   DSPSBMJOB

    In some was possible for Display Submitted Jobs to get a pointer
    error if there are a large number of job entries on the system.
    This has been fixed.

-   ENDSBSJOB

    The End Subsystem Jobs command was fixed to continue processing
    when a job not found condition was encountered. This avoids
    command exceptions due to system timing conflicts when jobs end
    before the command completes.

-   FNDCMD

    The Find Command tool would give a date conversion error when the
    command index file would exceed 183 days old. A parameter size was
    fixed to correct this problem.

-   INZPWD

    The INZPWD and INZPWD2 commands will only use GENRANPWD2 if
    QPWDRULES system value specifies *ALLCRTCHG. If it is not
    specified then the passwords generated for users will be follow
    simpler rules that might not conform to the password rules. This
    is desirable for help desk use.

-   MTNJRN

    The Maintain Journal command would not delete journal receivers in
    SAVED state if SAVINQMSG(*BYPASS) was specified and if the
    receiver had no object saved date. This could happen if the
    receivers had only been saved with GO SAVE 21 or SAVSYS. The
    receivers in SAVED state will now be deleted if they meet the
    attach or detach date qualfications for removal regardless of the
    save date.

-   MONMSGQ

    The job submitted by SBMMONMSGQ would occasionally report on
    messages that had blank message ids. These have been removed.

-   RTVAUDMDLF

    The IM type was missing as a valid type for the retrieve. This has
    been corrected.

-   RTVSYSSTS

    The Retrieve System Status command changed to correctly retrieve
    the LPAR current available processor for the CURPRCCAP parameter.

-   VALDBF

    The Validate Database File command has been changed to bypass null
    capable files, or files whose record length exceeds 4000. This
    improves VALMNYDBF, which would throw errors when these conditions
    were encountered. Now the files are bypassed, and a message is
    issued.

Incompatibilities

-   Commands that refer to previous releases (7.4 only)

    All save commands, most compile commands, and commands that use
    *PRV compiler support have had their TGTRLS parameters updated for
    7.4. While technically incompatible with previous release this is
    consistent with 7.4 system changes. The following commands have
    been affected: CHKTGTRLS, CMPOUTFILE, CRTBNDCL2, CRTBNDRPG2,
    CRTSFLPGM, CRTSFLPGM2, CRTTGTRLS, RPLGENPGM, RPLOBJ, RPLMOD,
    RPLPGM, RPLSFLPGM, SAVALLACT, SAVCHGACT, SAVJRNACT, SAVLIBIFS,
    SAVOBJIFS, SAVEONELIB, SAVOWNOBJ, SAVRCVL, SAVSNDL, SAVSNDM,
    SAVSRCF, SBMSAVRCVL, SBMSAVSNDL, SNDOBJMAIL.

2018-10-15 (R69)

Refresh 69 (October 15, 2018) is for IBM i 7.2 and 7.3.

No further refreshes will be made for IBM i 7.1. However, fixes to 7.1
tools will continue to be supplied on an "as needed" basis until April
30, 2021.

New Tools

-   ADDDSTLE2

    Add Distribution List Entry 2 is a new tool to assist with adding
    users to the same distribution lists to which another user
    belongs. If the user is already on one of the identified lists, no
    action is taken.

-   FNDMSGID

    Find Message ID is a new tool which will find the message file(s)
    that hold a message ID. This is very useful when handling jobs
    which list a message id with and unknown message file. The product
    issuing the message can often be identified this way.

-   SCNALLDSTL

    Scan All Distribution Lists is a new tool to scan all distribution
    lists for a particular User ID. An output file is created listing
    all the dist lists in which the User ID was found.

Enhancements

-   CVTIFSAUT

    Performance of CVTIFSAUT has been improved by streamlining the
    connection between it and the CVTIFSEAUT tool.

Fixes

-   CVTJOB

    The CVTJOB command would occasionally get decimal data errors when
    dealing with a very large number of jobs. The module using the
    QUSLJOB API has been rewritten to avoid this problem.

-   CVTLIBOBJA

    The Convert Library Object Authorities command would fail when
    LIB(*ALL) was requested. The tool has been fixed to handle the
    *ALL parameter.

-   CVTMSGQ

    The Convert Message Queue tool could fail in rare circumstances
    with an index out of range. This has been fixed.

-   DSPAUDLOG2

    The Display Audit Log 2 display was not updating the minutes field
    of the TIME column properly. This has been fixed.

-   DSPJOBSCDC

    The Display Job Schedule Calendar tool was showing jobs scheduled
    starting tomorrow. The tool was changed changed to display jobs
    that are scheduled to run from the system job scheduler for the
    next 7 days, starting today.

-   DSPJOBSCDE

    The Display Job Schedule Entry tool was always displaying jobs in
    scheduled order, even when SEQ(*JOB) was requested. SEQ(*JOB) now
    displays in job name order.

-   DSPSBMJOB

    The Display Submitted Jobs tool was not displaying the jobs that
    were submitted by the current user on behalf of another user. For
    example, if SBMJOB CMD(...) USER(OTHER) was used then that job was
    not appearing on the DSPSBMJOB display. In addition, jobs
    belonging to the current user, but not submitted by the current
    user were being displayed. Both of these problems have been fixed.
    DSPSBMJOB now functions as documented and behaves similarly to
    WRKSBMJOB.

-   DSPSBSJOBQ / WRKSBSJOBQ

    The DSPSBSJOBQ / WRKSBSJOBQ display output was not refreshing
    correctly. The job number in the header was not updating, and once
    a job queue had all completed jobs, the queue did not list
    *Nojobs*. Both these problems have been corrected.

-   EDTDTAARA

    The Edit Data Area tool will acquire an exclusive lock on the data
    area being edited. The tool presents a warning if you attempted to
    edit a character data area containing data with code points below
    x'40'. Canceling this warning failed to release this lock. This
    has been fixed.

-   GENRANPWD2

    The Generate Random Password 2 tool was throwing an error when
    PWDLVL was set to 0 or 1. GENRANPWD2 was generating passwords
    which included lowercase characters, which is not supported with
    PWDLVL 0 or 1, causing INZPWD2 and INZPWD to fail when requested
    to generate a random password. This has now been corrected in the
    GENRANPWD2 tool.

-   PRTREVERSE

    The Print Reverse tool was cutting off the last line of the last
    page when reverse printing a spool file. This has been corrected.

-   RTVIFSEAUT

    The Retrieve IFS Entry Authority tool uses system APIs that cannot
    be run if the job is multithreaded. Some tools, such as SNDSPLPDF,
    use APIs that now spin off threads in the current job. RTVIFSEAUT
    will now wait for those threads to finish instead of failing with
    an exception when used in those tools.

-   RTVSBSBCH

    The Retrieve Subsystem Batch Status tool would fail if the
    subsystem description for the named active subsystem could not be
    found in the library list. A fix was made so that the library of
    the active subsystems is correctly determined. In addition, the
    RTVSBSBCH command documentation indicated that *ALL was valid. It
    is valid on PRTSBSBCH, but not on RTVSBSBCH. The documentation has
    been corrected.

-   SNDSPLPDF

    The Send Spool as a PDF tool documentation was updated to indicate
    that both PASE and Transform Services are required to run this
    tool.

-   SPLSTO

    The Print Spool Store (PRTSPLSTO) command in the Spool Store tool
    (re)prints a stored spooled file. If that spooled file was created
    with an output queue specified as *DEV, *JOB, or *SAME then the
    output queue must be determined at run time. This is now done
    properly.

-   TAATOOL/TAAARCAC2 data area locked during install of the tools

    After an IBM i release upgrade the data area TAAARCAC2 in TAATOOL
    could be locked by the TAAINQMSG2 job. The install process for the
    tools now ends this job so that the TAATOOL library can be cleared
    and refreshed.

Incompatibilities

There are no known incompatibilities in this refresh.

2018-04-15 (R68)

Refresh 68 (April 15, 2018) is the last refresh for IBM i 7.1. Fixes
to 7.1 tools will continue to be made on an "as needed" basis until
April 15, 2020.

New Tools

-   GENRANPWD2

    The Generate Random Password 2 command generates a random password
    according to the system password rules which are set. This tool is
    available only on IBM i 7.2 and later.

-   RTVJOBOUTQ

    Retrieves the output queue of a job resolving any special values.

Enhancements

-   CVTJOB

    Convert Job was enhanced to add two new character timestamp fields
    for job start and end times. These are blank if they don't apply.
    This affects the model outfile. Outfiles from previous versions of
    the tool will need to be deleted. The tool will re-create these on
    first use.

-   DSPDTAQ, DSPDTAQD, and RTVDTAQ

    These tools have been enhanced to support data queues up to
    99,999,999 entries in length.

-   INZPWD

    The Initialize Password command(s) set a user profile to a new
    password. A new INZPWD3 password has been added in IBM i 7.2 and
    later. The password generated using INZPWD3 will comply with the
    system values.

-   SCNDBF

    A new parameter, IGNMAPERR, was added to the SCNDBF command to
    ignore data mapping errors when scanning. The default is *NO.

Fixes

-   CAPSYSINF

    The Capture System Information command was fixed to correctly skip
    /QSYS.LIB entries when capturing information on all IFS entries.

-   CLRMSGQ2

    Clear Message Queue 2 was not correctly marking message queues
    that contained messages that could not be deleted. This condition
    was rare. Those queues are now marked appropriately.

-   CMPSYSINFI

    The Compare System Information for IFS command was fixed so that
    the temporary files that are used in the will not require
    extension by the system operator.

-   CPYGENSRC

    When doing a CPYGENSRC FROMFILE(LIB1/*ALL) TOFILE(LIB2/*FROMFILE)
    the members that were selected for copy all ended up in the first
    file selected instead of the matching file name in the second
    library. This has been corrected.

-   CVTJRNA

    There were cases where CVTJRNA could issue an array bounds check
    if there were a large number of files being journaled to this
    journal. This has been fixed.

-   CVTLIBDBF

    Under rare circumstances on 7.3 the CVTLIBDBF tool would fail on a
    CPYF command insisting that the FMTOPT(MAP DROP) had to be coded.
    We added that keyword which fixes the issue. CVTLIBDBF is used by
    RGZLIB and the problem initially appeared in that context.

-   CVTWRKACT

    Convert Work Active would always include jobs with a blank status
    even if a desired set of active job status values was specified.
    Jobs with a blank active status are in a short-lived transition
    state and should not have been included. They will now only be
    included if STATUS(*ALL) is specified.

-   DSPDTAQ

    OUTPUT(*PRINT) would end with an MCH1210 when 9999 data queue
    entries had been printed. It now supports all the entries that can
    be retrieved with one call to the system API.

-   FNDSRCTXT

    The Find Source Text command would occasionally miss one of the
    members whose descriptive text matched the pattern given on the
    command. This has been fixed.

-   MSGCTL

    The MSGCTL tool was found to incorrectly log and forward messages
    that matched a generic message ID found in the MSGCTLP file. This
    has been fixed.

-   RTVJOBSTS

    The command can return a list of jobs if a specific job is not
    specified. The command and documentation were updated to ensure
    this was properly filtered by the CURUSER keyword.

-   SBMJOBSCDE

    The Submit Job Scheduling Entry submits a job based on the
    parameters in a job scheduling entry. One of these is the job
    description which was not found in some circumstances. This has
    been fixed.

-   SCNIFS

    The Scan IFS command was fixed to prevent looping on very large
    files.

-   WRKIPDEV

    The Work with IP Devices tool can be used to show remote printer
    queues as well as printer devices. This was showing SNA defined
    remote queues and showing the remote queue name instead of the
    host IP name of remote queues. It now shows only IP defined remote
    queues and gives the first 15 characters of the host name in the
    IP address field if the queue is defined with that instead of an
    IP address.

-   WRKSBSD2

    The Work Subsystem Description 2 command was incorrectly adding
    quotes to the compare value *ANY on the Routing Entries screen.
    This has been fixed.

-   WRKSYSINF

    The Work with System Information command now correctly removes the
    IFS entry information when removing a capture. This also fixes
    some interaction anomalies that may have occurred when removing a
    capture.

Incompatibilities

CVTJOB

-   The outfile for CVTJOB has been modified to add two new fields to
    the end of the record format. See enhancements above. Outfiles
    from previous versions of the tool will need to be deleted. The
    tool will re-create these on first use.

2017-10-15 (R67)

New Tools

-   DSPFCNUSG2

    Display Function Usage 2 is a new tool which generates a Function
    Usage Report. This report displays the list of function
    identifiers, along with associated usage information for each
    entry.

-   ENDSBS3

    The End Subsystem 3 command will quiesce a system, but not take
    the system completely to restricted state. All subsystems will be
    ended, except QCMN, QHTTPSVR, QSERVER, QSPL, QSYSWRK, QUSRWRK,
    TAAUPSMON, the controlling subsystem, and those specified in the
    OMIT parameter.

-   WRKACTGRP

    Work With Activation Groups is a new tool which provides a work
    display for all activation groups owned by the current job. An
    option to display attributes is available, as well as a reclaim
    option to free system resources.

Enhancements

-   CMPLIB2

    The Compare Library 2 command was enhanced by adding a CMPMBR
    keyword that can be used to suppress the member compare. This
    allows a shorter report to be produced.

-   CPYUSRPRF2

    The Copy User Profile 2 command was enhanced to include two new
    parameters that assist in using the command in batch mode. The
    PWDEXP parameter was added to allow a *RANDOM password be active
    rather than the default of expired. The CHGOWN keyword was added
    to allow the new profile to be owned by its creator rather than
    the default of QSECOFR.

-   RUNIO

    The Run I/O tool was enhanced to allow the output file to be
    located on an iASP and to provide more flexibility with the test
    record length. A limit was added to control the amount of disk
    storage consumed by the output file.

-   SAVSYSBCH

    The Save System in Batch command has been updated to include a new
    CHKSAVDEV parameter that allows you to skip the tape device check.
    This may be necessary if you are using BRMS.

Fixes

-   CHGOBJAUT

    The Change Object Authority command was receiving a "spooled file
    not found error" for its report when running inside a server job.
    It now correctly releases the spooled file if it is owned by a
    QPRTJOB.

-   CMPCMDLST

    Compare Command List compares 'select' and 'omit' lists to ensure
    uniqueness from each other. Fix added to handle *ALLUSR value
    passed from DLTUNULIB command.

-   CRTVTP

    The Display Virtual Tape command of the Create Virtual Tape tool
    would get an exception if there were no image catalogs on the
    system. This was a rare, but possible, occurence. This exception
    is now monitored.

-   CVTIFS

    The Convert IFS command would sometimes fail when given a symbolic
    link at which to start. This has been fixed.

-   CVTJRNA

    The Convert Journal Attributes command was ignoring the
    MBROPT(*ADD) option for the JRNRCVP file. This has been fixed.

-   CVTSYSVAL

    The Convert System Values command was not treating QALWUSRDMN
    values as a special "list type" value. It is now treated as such
    and converted appropriately.

-   DLTOLDQRPL

    Delete old QRPLOBJ objects would receive an MCH1210 (size error)
    when removing too many objects from QRPLOBJ library. The field
    size was increased to prevent this.

-   DLTOLDSPLF

    Delete Old Spooled Files is designed to allow clean up of old
    spool files by selection criteria. Found and fixed two extremely
    rare problems. Fixed to delete spool files of jobs with duplicate
    names due to job number wrapping. Fixed to prevent a MCH0603 when
    large numbers of excluded jobs were specified several times in a
    job.

-   DSPDTAQ

    Queue entries that were longer than 9000 bytes could cause a
    subscript range error when OUTPUT(*PRINT) was specified. The limit
    was increased to 10,000 bytes and 1,000,000 entries. The
    subscripting error has been fixed.

-   DSPIFS

    There was a bug in which the OWNER keyword used for selecting
    entries might be ignored under some circumstances. This has been
    fixed.

-   DSPWHRUSE

    Display Where Used shows which programs use, display, or call
    which files. Certain object types were being skipped. This has
    been fixed.

-   PRTBIGOBJ

    The Print Big Object tool assists in determining the large size
    objects on your system. The correct ASP number was not always
    shown on the report. This has been fixed.

-   PRTSPLSTO

    Print Spool Store is part of the Spool Store tool, which lets you
    capture spooled files and retain them online. An exception
    occurred when *DEV set as the job outq. This has been fixed.

-   SAVRSTASP

    Save and Restore ASP allows a library to be saved and restored
    from one ASP to another. Fix added to prevent error message to
    incorrectly be issued when parameter RSTASP set to *SAVASP.

-   WRKSPLF2 and WRKSPLF3

    It is now possible to release a spooled file that was in saved
    state in addition to held state.

Incompatibilities

-   No known incompatibilities have been introduced with this refresh.

2017-04-15 (R66)

New

-   RTVQATTD

    The Retrieve QATT File Description (RTVQATTD) command returns the
    values needed to create a QATT source file. These are the name,
    record length, and descriptive text of the file.

-   VRYVRTDSP

    The Vary Virtual Display command varies a virtual display or
    displays off or on, whichever is requested.

Enhancements

-   CHGTAAKEY

    The Change TAA Key command allows the information in the
    TAALICENSE data area to be changed. CHKTAAKEY was enhanced to
    include additional fields and the ability to submit in batch.

-   CHKSAVRST

    Added CPF4168 to the list of messages reported.

-   CHKTAP2

    The Check Tape 2 command is similar to the CHKTAP system command,
    with the additional function of sending an inquiry message to the
    device's message queue and allows the user a Cancel or Retry
    response. Additional information has been added to the reply
    message, indicating which tape volume is currently mounted.

-   CPYSPLFIFS

    The Copy Spooled File to IFS command copies a spooled file to the
    IFS as a stream file. Added support for AFPDS type spooled files.

-   CPYTAA

    The CPYTAA tool has been enhanced with two new keywords: CRTSRCF
    and ESCAPE. The intent is to be able to reliably pull include
    members from the archive during the building of a tool. This is
    part of our effort to bring service programs into the tools.
    Includes will be used to provide prototypes for TAATOOL APIs.

-   CRTTAATOOL

    The Create TAA Tool command has a new INCLIB parameter that
    accepts up to three libraries in which to search for includes.
    This is part of our effort to bring service programs into the
    tools. Includes will be used to provide prototypes for TAATOOL
    APIs.

-   ENDTAALIC

    End TAA License ends the license to the TAA Productivity Tools by
    placing an expiration date in the TAALICENSE data area on a
    particular machine. ENDTAALIC was changed to show the machine
    serial number, so the user can determine which machine the license
    was ended on.

-   PRTSRCSUM

    The Print Source Summary command is similar to DSPFD with MBRLIST
    option, but offers better formatting and several important
    options. Change was made to include new QATT* source files.

-   SCNALLSRC2

    Scan All Source 2 command will scan for up to 20 arguments in all
    souce files in one or more libraries. Additional file member
    attributes retrieved and outfile support added.

-   SCNSRC, SCNALLSRC, SCNALLSRC2

    The member change date and member descriptive text were added to
    the outfile. The model file is TAASRCFP and results in the outfile
    SRCSRCP. The record format level identifier has changed as a
    result.

Fixes

-   ADDJOBSCD2

    The Add Job Schedule 2 command adds one or more job schedule
    entries from the JOBSCDP file created by the CVTJOBSCDE TAA Tool
    to the system job scheduling function. A fix was added to handle
    descriptions that include apostrophes.

-   CHKSAVRST

    The CHKSAVRST command checks a job log that uses save/restore
    commands and prints a listing with the completion messages and any
    error diagnostics. Message handling was added for CPF4168.

-   CHKTAAAUTL

    The Check TAA Authorization Lists command checks to ensure that
    all TAA Authorization Lists are set to PUBLIC EXCLUDE. Completion
    messaging was changed to be more accurate.

-   CPYFRMCSV

    The Copy From CSV 2 command (CPYFRMCSV2) of the CPYFRMCSV tool was
    maxing out at 13000 records in its temporary work file. This has
    been changed to *NOMAX.

-   CPYJOBSCDE

    The Copy Job Schedule Entry command would complain about an
    invalid date when copying entries that had *MONTHSTR as the
    scheduling date. This has been fixed.

-   CPYSPLFIFS

    Copy Spooled File to IFS copies a spooled file to the IFS as a
    stream file. Documentation was added stating that overprinting is
    not supported and will cause duplicate data to appear.

-   CVTIFS

    The Convert IFS command converts directory entry attribute
    information from the IFS and outputs the information to the
    IFSDIRP data base file. An IBM i discrepancy in reporting
    authorization errors for distributed directories caused a loop
    when such an error was encountered. This manifested itself when
    processing directories in QNTC. A workaround was added for these
    *DDIR types.

-   CVTMSGQ2 Convert message queue 2 can convert a large number of
    messages found in an external message queue to an outfile. Problem
    was fixed where messages with blank message ids (such as inquiry
    messages) were being removed incorrectly.

-   CVTPGMA

    The Convert Program Attributes command creates a data base file
    with one record per program. New ACTGRP parameter was added to
    retrieve activation group information.

-   CVTQHST

    There was a possibility that on very active systems CVTQHST could
    produce an intermediate QPDSPLOG spooled file that hit its MAXRCDS
    limit. This has been fixed.

-   CVTSYSVAL

    The Convert System Values command converts the spooled file output
    from WRKSYSVAL to the SYSVALP file. A fix was added to correct how
    long values are returned.

-   DSPACTJOB2

    The Display Active Jobs 2 command provides a display similar to
    WRKACTJOB except that the user can only perform the Display
    action, and jobs are sorted by CPU%. Fixed subscript out of bounds
    problem when system had a very high number of jobs.

-   DSPAUTLOB2

    The Display Authorization List Objects 2 command expands
    DSPAUTLOBJ functionality by 1) including IFS and DLS objects
    and 2) allowing a generic name or all authorization lists. A fix
    was made to correctly display lists with over 7500 entries.

-   DSPDTAQ

    The Display Data Queue tool displays or prints the entries of a
    data queue and the data queue attributes. DSPDTAQ was fixed so it
    will now correctly return up to 500,000 entries without throwing
    an exception.

-   DSPIFS

    The Display IFS command provides a display or listing of IFS
    objects. Documentation was corrected to state that directories are
    always included in the listing.

-   DSPOBJ

    The Display Object command provides various DSPxxx commands for
    most object types. Removed ALL and ALLUSR options from the OBJTYPE
    parameter on the command.

-   DSPOBJAUD

    The Display Object Auditing command displays all audited objects
    in a list of libraries or all libraries. The tool was fixed to
    give an informational message if a single empty library is
    specified.

-   ENDJOBWOL

    The End Job With Locks command ends jobs with locks on a specific
    object. A fix was added to correct the command name in the
    documentation.

-   MOVALLOBJ

    The Move All Objects command moves one or more objects from one
    library to another. SQLPKG support was removed from the command,
    as SQL packages must remain in the library they are created in.

-   PRTDEVCFG

    The Print Device Config command prints a copy of the device
    configuration objects and copies the contents to a source member
    in a source file. Code was changed to delete the DSPOBJP file
    before using it.

-   RTVRELMTH

    The Retrieve Relative Month command failed if it was "backing
    into" December from a later month. This has been fixed.

-   SAVLIBSAVF

    The Save Library to Save Files command saves one or more libraries
    to save files in a specified library. Command was fixed to handle
    library lists longer than 256 characters.

-   SCNGENSRC

    The spooled file created by SCNGENSRC was named after the first
    member processed for each candidate source file. It is now
    correctly named after the source file itself. The USRDTA of the
    spool file is now correctly specified as SCNGENSRC rather than
    SCNSRC. The number of members scanned is now correct.

-   SCNSRC

    A minor fix was made to correct the number of members scanned when
    used by SCNGENSRC.

-   SNDDTAQ

    The RCVDTAQ command of the SNDDTAQ tool might receive a MCH0603 (a
    subscript or character string length violation) if the MAXLEN of
    the queue was over 5000 and the entry being received was over 5000
    in length. This has been fixed.

Incompatibilities

-   There are no known incompatibilities that have been introduced
    with this refresh.

Copyright TAA Tools, Inc. 1995, 2020
					

Added to TAA Productivity tools October 15, 2017


Home Page Up to Top