Estorian Portal Login| Contact| Careers
TSF zSeries FAQ
Frequently Asked Questions
General
TSF Professional — zSeries Suite
General TSF
TSF Functionality
GUI Client - General
GUI Client - Reports
Agent
TSF Utilities Functionality
DFSMShsm
Automation
Tape

General

What is Storage Resource Management?
Storage Resource Management (SRM) is a collection of monitoring, analysis, reporting and automation tools that enable administrators to visualize a disparate collection of storage resources (storage devices, applications, and files) and provide insight and information on those resources. In turn, these tools allow an administrator to make or automate knowledge-based decisions about those resources, applications, files and the users and processes that affect them.

Why are companies implementing Storage-management solutions?
The explosive growth of and dependence on data is placing an increasing value on storing, managing, and protecting it. Data, not computation, is the basis for nearly all of the strategic value created by information technology today. Reliable storage of and access to data is a mission-critical necessity for maintaining a competitive edge. The ability of a company to convert their ever-growing amounts of stored data into knowledge and usable information is its key to competitive advantage!

What business challenges does storage-management address?
As information continues to drive worldwide growth, several critical challenges face information systems professionals:

Shortage of qualified IT staff: With business locations around the world, data centers have been extended and multiple operating systems are common. As demand continues to outpace supply, it becomes increasingly difficult and expensive to locate and retain qualified IT staff to handle these environments.

Meeting Service Level Agreements: Demand on limited staff is increasing as availability and performance expectations continue to rise.

Keeping systems and information available: Companies cannot afford the lost productivity incurred during planned or unplanned downtimes. As a result, time available for backup and disaster recovery testing is shrinking dramatically, while efforts to support business continuity are in strong demand.

Maintaining flexible storage infrastructure: Business requirements change quickly. Companies need to add and re-deploy open-systems hosts regularly; the storage supporting these systems must be flexible, and IT personnel must have the ability to reallocate resources dynamically.

Forecasting capacity and consumption requirements: Growth in the volume of required data means IT personnel must constantly analyze trends in performance and usage to efficiently allocate resources and stay ahead or customers' needs.

How can I upgrade my TSF Suite software?
TSF Suite is specifically designed to be easy to install and upgrade. Estorian is committed to providing annual upgrades with simple-to-follow instructions.

Who provides service and support for Estorian's solutions?
Estorian offers its customers excellent worldwide service and support provided directly or through one of our solution partners.

Support varies depending upon which level of TSF is being used.

TSF zExpress - FAQ, Email

TSF Professional - zSeries - FAQ, Email, Phone and Support Portal

What is the warranty on Estorian solutions?
Estorian TSF Suite solutions come with a 90-day warranty for defects on software.

How can I get a free demonstration?
Contact Estorian's sales team for a free demonstration at sales@estorian.com

Where can I buy Estorian's storage-management software?
Please visit Estorian's Product page for a download of the software. At that time, you will be presented with several options for purchase.

Are there different purchase options available?
Estorian provides flexible options for monthly subscription of the software. There is no long-term commitment or expensive upfront fees.

I heard that Estorian has announced major partnerships with ASG Software Solutions (ASG) and IBM Global Services (IGS). Does that mean I can now acquire Estorian TSF Suite solution through ASG and IGS?
Yes. Estorian TSF Suite solutions are now available through ASG and IGS because of our global partnerships with these two leading solutions providers.

top

TSF Professional — zSeries Suite

What does the TSF Professional — zSeries Suite consist of?
The TSF product offering is a suite of robust storage-management tools for mainframe Disk, Tape, HSM and Catalogs that effectively automate, monitor, analyze, report, and predict data activity. TSF ensures that critical storage data is always available and existing resources are used most economically. Installed in less than half a day, TSF lowers administrative costs and helps IT administrators gain control of mission-critical data.

What new functionality is provided in TSF?
The most significant development in TSF is the introduction of a graphical user interface that controls mainframe storage from a unified console along with extended functions to transform history data into trending analysis. Automation for the mainframe is available for ALL collected data and is done in "collection real time," which means single pass automation instead of two-pass thus reducing resource consumption. Estorian also provides a subscription service option that drastically reduces upfront costs.

What storage platforms and tape management systems does TSF support?
The storage platforms and tape management systems supported by TSF include:

IBM z/OS, V1R1 and later

IBM DFSMS

IBM DFSMSrmm

Computer Associates CA-1

Computer Associates CA-Dynam/TLMS

Why does TSF average less than half the CPU overhead of competitive solutions?
TSF is a storage-management solution developed by storage administrators for storage administrators. TSF, unlike other S/390 storage-management solutions, is designed to conserve CPU resources by leveraging an internal VSAM database and a unique architecture to monitor real-time SMF data.

top

General TSF

How do I take an action on datasets and/or volumes once they are displayed in a report?
Features such as ProActivity and Line Commands exist within the product. Enter a forward slash (/) next to any entry and get a menu of actions that may be directly invoked. ProActivity is invoked from the command line and it allows the user to execute skeleton control cards, which were previously defined, so that a JCL job stream can dynamically use the current list as input.

How can I create a batch equivalent to an online report?
Each component of TSF has a batch job that will allow the user to generate the same results in batch that can be generated online. Please note the following member names in the TSF CNTL dataset that correspond to the respective online components:

Pools/Volumes      TSFVOLLS

Datasets       TSFDSNLS

DFSMShsm Detail      TSFMCDS & TSFBCDS

Tape Volume      TSFTVLST

Tape Dataset      TSFTDLST

How can I create a filter for batch reporting?
Parameters can be passed to programs by two different methods:

Using the PARM parameter on the JCL EXEC statement. For example:

PGM=SFMDSP02,PARM='DSN(SYS1.*.**),DSORG(PS)'

Using the new PARMDS parameter in TSF v 4.4.0.:

PGM=SFMDSP02,PARM='PARMDS(Y)'

Once this PARM is on the EXEC statement, locate the //STEPn.PARMDS DD * statement near the bottom of the JCL and code it accordingly. There are comments in the JCL displaying the available parameters.

//STEPn.PARMDS DD *
SET DSN(SYS1*.**,+CICS*.**) SET DSORG(PS)

Unlike JCL limiting the number of characters on a PARM statement, this later method does not have any such restriction.

How can I save, retrieve, or edit queries?
In the TSF ISPF interface, execute the query that you want to save, press F3 to return to the filter panel, and then type SAVEQ on the command line followed by a space and an eight character name for the query. Press enter. When prompted, type a description of the saved query.

To retrieve any saved query in the TSF ISPF interface, type GETQ on the command line of a filter panel, followed by a space and the name of the query that you want to retrieve. Alternatively, to display a list of all saved queries, just type GETQ on the command line of a filter panel, without a query name. You can then select the desired query.

To edit an existing saved query in the TSF ISPF interface, just select it, make the desired filter changes, execute it, press F3 to go back to the filter panel, and save it with the same name.

In the TSF GUI interface, just click Save for a newly designed query. The saved query will now be displayed in the tree window on the left under the component from which the query was saved.

How can I set or modify security access within the various components of TSF?
You can provide SAF compliant UPDATE access for TSF components via Facility Class Profiles. See Table 3.5 (TSF Components and Security Settings) in the TSF Installation Guide.

How can I modify the ISPF panel displays in the product so that I don't have to keep scrolling to see my desired results?
You may change the panel default by specifying, "panel default Pn", where n is the panel number that you want as the default. To jump to a specific panel quickly without having to scroll, type Pn, where n is the panel number that you want to view.

How do I turn Logical Pooling on?
Within Pools/Volumes and Datasets you do not have to set Logical Pooling because it is now set for you if any pools are defined in the specific tables. However, within DFSMShsm and Tape, the POOLTABL and POOLVOL parameters must be defined when building the respective databases. See Chapter 5, Installation Settings, in the TSF Installation Guide.

There are certain logical pools built using generic, esoteric and SMS attributes at the dataset level (Management Class and Data Class) and the volume level (Storage Group, esoteric, and generic). Logical dataset pooling is done within the POOLTABL member and Logical volume pooling, both DASD and TAPE, is done within the POOLVOL member.

What is a Logical Pool?
A logical pool is a customizable group of datasets or volumes that can be reported on and analyzed individually. These are usually defined to mirror or represent an application, business unit, client, customer, etc.

How would I use Logical Pools?
Refer to member POOLTABL in the PARMLIB dataset for formatting. This is essentially grouping datasets logically via dataset pattern masking. For instance, any dataset with PAY in the dataset name belongs to the PAYROLL pool, any dataset with CICS in the dataset name belongs to the CICS pool, or any dataset with DB2 in the second node belongs to the DB2 pool. Additionally, you may refer to member POOLVOL that allows grouping by volume, volume masking, or by unit addresses.

How can TSF assist with my charge-back application?
During installation when executing TSFSET (UCBSCAN), there is a variable called DASD Cost Per MB. This amount should reflect the cost per megabyte you would charge for DASD. The Pools/Volumes and Datasets filter panels allow a "$" to be used in place of T-Tracks, M-Megabytes, etc., so the resulting display would return a dollar amount instead of tracks or megabytes. In addition, by using POOLTABL, you can logically group datasets by pattern masking them into logical pools or applications.

Note: TSFSET (HSMSCAN) and TSFSET (TAPESCAN) panels also have the Cost Per MB variable.

How do I display real-time DASD statistics without re-populating the STORDATA VSAM DB?
Within the DASD filter panel set Refresh to Y.

How do I re-populate the STORDATA VSAM DB?
There are several ways to accomplish this:

  1. You may issue F TSFTASK, and run TSFDSNCT collection, usually option 2, to repopulate the database. This is the preferred option as automation takes place only during this process.
  2. You may run the TSFDSNCT batch job. Automation does not take place during this process.
  3. Within the Pools/Volumes DASD filter panel, enter Y for the Refresh field to request the TSF task to update the volume data and display volume information. Default is to refresh VOL/POOLS every ten minutes. Automation does not take place during this process.
  4. Within the Datasets filter panel, enter Y for the Refresh Data field. This will refresh the STORDATA VSAM database. Automation does not take place during this process.
Note: This could tie up your TSO sessions for an extended length of time.

How do I identify which TSF component uses which collection method?
See below:

TSFDSNCT will refresh the STORDATA database (used in Pools/Volumes, Datasets and the GUI), and the HLQ database (used in Utilities).

TSFCATCT will refresh the Catalog database used in Utilities.

TSFRMMCT will refresh the Tape database for RMM

TSFCA1CT will refresh the Tape database for CA-1

TSFTLMCT will refresh the Tape database for TLMS

TSFHSMCT will refresh the DFHSMsms Detail databases.

TSFSPACE and TSFRECRD populate the DFHSMsms Zoom database in real time.

How do I change the number of control cards included a Proactivity job?
Execute the TSF Settings panel from option 6, TSO Commands as follows: EX ‘HLQ.STSFPENU(TSFSET)’. Navigate to the UCBSCAN Settings panel and change the value of the Cntl cards per Job field (default is 200) to the desired number of control cards per job. See Chapter 5, Installation Settings, in the TSF Installation Guide.

How can I pass query results into control card statements and JCL for Proactivity?
TSF is distributed with a number of control cards within the HLQ.TSF.PROACT library. Upon executing a TSF query and the desired results are displayed, commands can be entered on the command line to invoke the control card members that will build JCL for any desired action. Please refer to the Proactivity section in the user manual for more information.

How do I use my own control cards in Proactivity?
You may add whatever skeleton control cards you like in the Command library. They may also include other vendor utilities.

How do I schedule database collections at specific times?
You should use the collector (TSFCOLxx) to schedule attribute collection so automation will take place. Use the IF statement option for automation of other tasks as needed.

top

TSF Functionality

What is the purpose of the Use Multiple DB variable?
This variable provides a way for Datasets to have multiple STORDATA VSAM databases for access. You must set it to Y on the TSFSET (UCBSCAN) panel during installation. Once set to Y, when you select the Datasets component of TSF, a prompt will be displayed asking which database you wish to use. If one has not been previously saved, select the default. Once in Datasets, type SAVEDB on the command line, along with a unique name to call this database. You will then be provided with a table to type a description for this database. While in Datasets, you can switch to another previously saved database by typing GETDB along with the saved database name. Alternatively, type GETDB and press enter to display a table with saved database names and then make a selection.

What are the advantages of the Use Multiple DB variable?
This lets you limit the information being collected; thereby reducing the time it takes to build the database, and the response times when retrieving information from the database. Another benefit is that it allows the databases to contain specific data where the intent is to restrict access to certain databases for any particular group or user.

How do I turn countdown on/off?
Go to the TSF DATASETS panel, option 1, then select option 1 again and Specify CntDwn=> N or Y

How do I display real-time DASD statistics without re-populating the STORDATA VSAM DB?
Within the Pools/Volumes DASD filter panel enter N for the Refresh field to request the TSF task to display volume information without updating the volume data.

How do I determine the amount of wasted KBs within a track?
Using "UNUSEDKB(Y)" in the TSFDSNCT job will calculate the used KBs on each dataset allocation.

Note: Using "UNUSEDKB(Y)" will cause the database build job to run longer.

top

GUI Client - General

How do I modify the default unit GUI displays?
When in the GUI, you can click on the drop down box for units to change the default settings for displaying data.

Can I choose which columns are displayed?
Yes, with the TSF GUI Client, you are able to select which columns you want to have displayed in the current view as well as in Saved Views and Reports. To change the selected columns, click the Column tab. In the Column Order Chooser window, all available columns appear in the Target column by default, which means they will be displayed. In the Target column, use the cursor to select the columns that you want to remove from the displayed view/report and then click the right arrow button. Alternatively, you can click the double-right arrow button to move all columns to the Source list. Apply the changes once you have just the desired columns displayed in the Target list.

Note: Columns that are set in the Target list will affect the columns on the Detail/Zoom tab as well as on the report. Also, note that column selection applies only to the Detail or upper level zoom tabs. There is no control over columns displayed from some tables such as Summary tables or lower level zooms. Scheduled Reports will however give the user control of the columns displayed for sub-Zoom tables and summary tables.

Can I change the sort order for the records returned?
Yes, the TSF GUI Client allows the user to select which columns sort the records. Additionally, the user can choose to set the sort order as Ascending or Decending. To set the sort order for a view, navigate to the Sort tab. In the Sort Order Chooser window, all available columns appear in the Source column by default, which means they are not affecting the sort order. To select columns on which to base the sort order, use the cursor to select the columns in the Source list and then click the right arrow button to add them to the Target list. Alternatively, click the double-right arrow button to move all columns to the Target list. Double click on items in the Target list to change the order from Ascending to Descending and vice-versa.

Note: The sort order set in the Target list will affect how the data is sorted on the Detail/Zoom tab as well as on reports.

How do I resolve system not responding message?
This message may be received if the TSFAGENT is not running, if there is a network connectivity issue, or if the System Configuration specified in the TSF GUI Client is incorrect. Start by verifying that the TSFAGENT task is running on the z/OS system. Next, make sure that you have normal TCP/IP communications from the TSF GUI Client to the TSFAGENT by sending a PING request from the client system to the TSFAGENT system. Next, make sure that the Host Name and Port specified for the z/OS system is correct for the currently running TSFAGENT. To do this, first determine the Port Number that was specified in the TSFAGENT job on the z/OS system. Then in the TSF GUI Client, open the Configure Systems dialog and click on the z/OS tab. Verify that the values specified in the Host Name and Port fields match the z/OS System name and the Port specified in the TSFAGENT job. Additionally, make sure that the User Name and Password specified are correct for a valid user with proper permissions to access the TSFAGENT. At this point, you should be able to click on the Database Name field, and get a list of the available TSFPRMxx members. If these steps do not resolve the issue, contact your system administrator or Estorian support.

How do I resolve invalid username/password message?
Verify your user name and password is in fact your TSO USERID and password. On the View menu, click Configure Systems and then click on the z/OS tab. Re-enter the User Name and Password, then click on the Database Name dropdown to refresh the list of available TSFPRMxx members.

How do I change my password for the GUI session?
On the Tools menu, click Change Password.

How do I reset my password for the GUI if I forgot what it was?
The user is able to correct a lost password but the process involves the loss of preferences specified in the Common section of the preferences dialog and will invalidate the passwords that are specified in the Configure Systems dialog for connecting to z/OS systems. Follow these steps to recover from a lost password:

  1. Close the TSF GUI Client.
  2. Navigate to the TSF2_1 folder in the user home directory (C:\Documents and Settings\).
  3. Make a backup of all files. If something goes wrong, you can paste these files back to the TSF2_1 folder to restore the configuration.
  4. Delete the prefs.xml and prefs.xml.bak files.
  5. Re-launch the TSF Client.
  6. Specify the new password, confirm it, and then click OK.
  7. On the View menu, select Configure Systems.
  8. Re-enter the passwords for all configured systems. For z/OS systems, you should confirm that you are able to re-connect by clicking on the Database Name drop-down list for each configured z/OS system to refresh the list of available TSFPRMxx members.
  9. On the Tools menu, select Preferences. Re-set any lost preferences in the Common section to their desired values.


How do I modify the default graph item count?
On the Tools menu, click Preferences. In the Preferences dialog box, click User under the Common folder in the left pane and then in the right pane, type the number of items to be graphed (as a default) for the Initial Graph Count.

How do I modify the displayed graph characteristics?
Execute a filter and right click on the graph. In the Graph View dialog box, click the Graph Properties tab. Click the General tab to change the Graph Type, Graph Orientation, or Label Orientation. Click the Data Source tab to select the column label names for the graphic and to select the Source columns.

How can I save, retrieve, or edit queries?
After you click the Save button for a newly designed view, enter a name in the "Save View As" field on the dialog box and then click Save. The saved view will now be displayed in the tree window on the left under the component where it was saved. To retrieve or edit an existing view, simple click on the saved query name in the tree view and either execute it or edit for desired changes.

Why does the Find function in the Client appear not to have set the focus correctly if the string to find exists on a hidden column?
The FIND function is designed to search on ALL data in the table whether showing or not. Show all columns when using the FIND function.

Why does the TSF Client periodically appear to hang and does not respond to user selections?
JAVA memory management issues are usually to blame and hard to track down. This usually occurs when the results returned by a query exceed the maximum memory allocated to the JAVA JVM. By default, the TSF Client allocates 256 Megabytes as the maximum amount of memory available. This amount can be increased by modifying the client Start method to have a higher value for the "-Xmx" property that controls the amount of memory available to the JAVA JVM. The default value is -Xmx256M (Where the M represents Megabytes). So to change the available memory to 512 Megabytes, just edit the property to -Xmx256M. The method for editing this property depends on how the TSF Client is being launched. For instance, if the TSF Client is launched via the Windows Start menu, then right-click on the start menu short-cut (Icon) and select Properties. Then on the ShortCut tab, change the -Xmx property in the Target field. Restart the TSF client and re-query. If the problem persists, then add more system memory and reset the -Xmx property to a higher value. Be careful not to set the -Xmx property equal to the total amount of system RAM, or system instability may result. Leave at least a 256M differential between the amount of available system ram and the amount allocated to the TSF Client. Alternatively, restart the TSF Client, and re-execute the query with a filter criteria that will reduce the number of records returned.

Can I launch the vertical row browser without having to right click and select the option?
The user can double click on a row, which will launch the Row Browser.

top

GUI Client - Reports

Can I schedule reports in addition to manually generating reports?
Yes, with the Scheduled Report feature, you are able to schedule reports on a Periodic, Daily, Weekly or Monthly basis. Additionally you can choose to Preview the report and can choose to Publish the report manually.

Can I report on objects across multiple systems and/or tools?
Yes, with the Scheduled Report feature you can append report items from one query to the report items from a completely different query, even from a query generated while connected to a different system.

What report formats are supported?
Reports can be generated to HTML and PDF formats, along with being sent to a printer.

Can I send email notifications when reports are published or scheduled?
Yes, you can specify to send the scheduled or published HTML or PDF report as an email attachment and can include a link to the location where the report was generated. You can also choose to send a URL link if you would rather that the user access the report via a web page.

How do I include my companies branding on reports?
On the Tools menu, click Preferences. In the Preferences dialog box, click User under the Common folder in the left pane. In the right pane, type the full path to the image desired for the report in the Values text box for Printed Reports Logo Path.

How do I choose which report items are in a report?
Click the Report tab, and in the Report Item Chooser window, all available tables and graphs appear in the Source column by default, which means they are not selected for inclusion in the Report. Use the cursor to select the tables and graphs that you want to include in the report and use the right arrow button to add them to the Target list. Alternatively, click the double-right arrow button to move all tables and graphs to the Target list.

How can I add text to a report?
Press the Add Text Block button. The Text Block Editor dialog lets you enter free form text with basic editing features to set the type and size of font, the text alignment, and the format such as bold, italic, and underline.

Can I change the scheduled report properties once I have created it?
Yes, once you have created a scheduled report, use the Scheduled Report Editor to change the report items that are displayed, and can edit the interval of the report or even what type of report is generated. To access the Scheduled Report Editor, click on Tools and then Edit Scheduled Reports from the main menu of the TSF Client.

Can I select which printer the reports will be generated to?
At this time, the report will automatically be generated to the default printer defined for your system. Adding support for selecting optional printers is planned for a future release.

Can I publish or schedule reports to be generated to a network share?
Yes, reports can be generated to a CIFS share, if you have permission to access the share. When you first publish or schedule a report to a network share location, you will be prompted to supply a valid Domain, User and Password for use when making the connection.

What happens if I schedule a report to be Monthly on the 29th - 30th day, and the month does not have that many days in it?
The scheduled report will be generated on the last day of a month that contains less days than the day of the month that was specified.

Can I edit the selection used to perform a Zoom on a scheduled report?
There is no mechanism through the Scheduled Report Editor to change the record that was selected at the time that a Zoom table or graph was generated. For instance, lets suppose that you executed a Drives query that returned several drives, and then wanted to zoom to the Volumes level for one of the drives and add the volume zoom level table and/or graphs to a scheduled report. This is a perfectly valid thing to do, but you will not be able to later edit the drive that was selected at the time you performed the zoom. You can however use the Scheduled Report Editor to select the existing zoom level report items and delete them. You can then re-execute a query that will return the desired drives, select the drive that you want to zoom on, and then append the resulting volume zoom report items to the Scheduled Report.

Can I change the date range that was used to generate a History or Forecast report item?
Yes, through the Scheduled Report Editor, select the desired scheduled report. On the Properties tab, select the History or Forecast table that you are interested in changing. You will then be able to change the History or the Forecast range on the respective History or Forecast tab.

Note: You can only change the date range for a History or Forecast table. If you have a History or Forecast graph object included on the scheduled report, the criteria used to generate the graph will be changed when you edit the corresponding table. If there is no corresponding table, you will need to delete the History/Forecast graph object then re-generate it and append it back to the scheduled report in order to change the date range.

I made some edits to a scheduled report, but when I go back to the report the edits were lost. What happened?
You must choose to save edits made to a scheduled report before you navigate to another scheduled report or close the Scheduled Report Editor dialog. You will not be prompted that you have not saved your changes when you have unsaved edits and navigate away from the scheduled report.

I included a URL in the email notification for a report, but the link is not active when it is received in my email client. What causes this?
There are several possible reasons for this. First your email client must support HTML for the URL to be an active hyper-link. Additionally, some email clients will treat a URL such as www.teracloud.com as a valid hyperlink, but other clients will not. Try specifying the URL with the http:// prefix (e.g. http://www.teracloud.com)

I am trying to generate a PDF report but it appears to run out of memory and is not generated. An HTML report returning the same number of records and report items generates with no problem. Why is this?
PDF reports consume much more memory per report item than the HTML version does. If possible, utilize HTML format for reports that return large numbers of records. If you absolutely need the report to be in PDF format, try restricting the number of columns selected to just the minimum amount necessary.

How can I tell if the Scheduled Report service generated a report?
The RSSService log file details which reports are generated and not generated. This log will also indicate the report output path location where the report was generated. The log can be found in the TSFClient2_1/bin directory in the TSF Client install location.

Will I receive notice that a scheduled report failed to be generated if it is too large?
You can receive an email notification in the event that a scheduled report is not generated because it causes an out of memory condition. To receive notification, you must select the Email Result option for the scheduled report. Note that the email will be sent to all recipients.

I have a report that appears to generate an out of memory condition. How can I correct this?
There are several possible solutions to this:

  1. If the report is a PDF report, try generating it as HTML instead. PDF reports consume much more memory than HTML reports.
  2. If possible, use the Filtering capabilities of the TSF Client to reduce the number of records returned in the report.
  3. If you are unable to reduce the number of records returned in the report, try to reduce the number of columns that are displayed. Additionally, consider separating the Graphs and the Summary tables to a different report than the detail records.
  4. Increase the amount of RAM available to your system. Note: this will also require a change to the maximum amount of memory that is made available to the JAVA virtual machine that the TSF Report Schedule Service runs under. To increase the amount of RAM available to the TSF Report Schedule Service, perform the following tasks:
    1. Stop the TSF Report Schedule Service
    2. Navigate to the TSFClient2_1/conf folder in your TSF Client installation directory.
    3. Back up the wrapper.conf file.
    4. Open the wrapper.conf file in notepad or a similar text editor.
    5. Find the line that says "wrapper.java.maxmemory=512".
    6. Edit the value to represent the amount of memory in megabytes that you want to allocate to the TSF Report Schedule Service. Make sure not to specify a value that is equal to the total amount of memory available on your system, or system instability may result. It is best to leave at least 256 MB differential between the amount of available system RAM and the amount allocated to the TSF Report Schedule Service.
    7. Save the changes to the wrapper.conf file and restart the TSF Report Schedule Service.

The scheduler service is not generating expected reports. This seems to happen no matter how small the report is, what interval I select and even if I specify a local path that I know exists and I have permission to. Also, after re-starting my machine or the TSF Report Schedule Service, I am no longer able to start the TSF Client. What is causing this?
This appears to be an intermittent issue caused by a bug in the Java/Windows Service implementation that the TSF Report Schedule Service uses. For the time being, the only solution to this issue appears to be changing the TSF Report Schedule Service to run under a Local/Domain user account rather than running under the LOCALSYSTEM account. To see if this is the case, perform the following steps:
  1. Open the Windows Services console (services.msc) and stop the TSF Report Schedule Service.
  2. Select the TSF Report Schedule Service, then right-click and select Properties.
  3. Click on the "Log On" tab.
  4. Select the "This Account" radio button.
  5. Specify a local or domain user in the "This Account" input field. Make sure the user that you specify has permission to access the TSFClient2_1 folder in the TSF Client installation directory, and also has permissions to all user home directories if the TSF Client is used on a machine where more than one person will be sharing the TSF Client and creating scheduled reports.
  6. Specify the password for the selected user and confirm it.
  7. Apply the changes and restart the TSF Report Schedule Service.

Are there any tips for helping to keep track of the selections that were made as the basis for a Scheduled Report?
There are a couple of tips that can make it easier to correlate the Filter/Sort/Column/Zoom/History/Forecast selection that serve as the basis for the report:
  1. Create a Saved View that correlates to the Scheduled Report Items. First enter any filter criteria, sort selections and column selections, then apply all changes and execute the query. Make sure that you get the records/view you anticipated, then save the view with a name that will help you correlate the view to the Scheduled Report. Now you can add the Report Items that you are interested in to the Report tab target list and schedule the report. When the report is generated, you can just execute the saved view to help make sure that you are getting the expected report items. Note that this method will not help you determine the selections made for Zoom, History, or Forecast selections.
  2. For Zoom, History, or Forecast selections you can edit the Report Item labels to help remember what selection was made at the time that the report was generated. For instance, say that you performed a history request on a VOLUME named VOL1. You could edit then edit the generated History table report item to have a name such as "History Table: VOL1" and the History graph to have a label such as "History Graph: VOL1". Note: Be careful not to give Report Items the same name as this may lead to a known issue where the report items are not generated correctly. You can edit the Labels directly on the report tab, or from the Scheduled Report Editor. To edit the report item label from the Report tab, you must first add the report item to the Target List, then select the report item and right click on it. You can then select "Edit Report Item Title" and make the desired changes. To edit the report item label from the Scheduled Report Editor, first select the desired scheduled report. On the Report Properties tab, find the report item that you want to edit, then click in the Report Item Name field. You can then just type the new Report Item title. Make sure to save your changes before giving focus to another scheduled report or closing the Scheduled Report Editor.


I get inconsistent results when making multiple Font, Size, Alignment, and Color selections in text blocks on reports. Is this a known issue?
We are aware of the issue and should have a resolution soon. The work around is to make sparing use of these selections and break them up into separate text blocks. So for instance if you have three lines of text where you want to have one be Bold - Red, one Italic - Blue and one Underlined - Green, create them as three separate text blocks.

Will changes to Preferences be reflected in the scheduled reports?
Yes, scheduled reports will be generated based on the current preferences for such things as Byte Calculation and Cost prefereces.

Will changes to the Units dropdown be reflected in the scheduled reports?
The scheduled reports will not be affected by making a change to the Units dropdown. The unit that was selected at the time the report was scheduled is retained in the Scheduled Report. You can however use the Scheduled Report Editor to change the space columns to use a different unit. In the Scheduled Report editor, each space column (e.g. Volume Capacity <UNIT>) displays a separate column for each of the unit selections. So for instance, If you had the Units dropdown set to MB at the time that you scheduled your scheduled report and the report contained the Volume Capacity (MB) column, you can use the Scheduled Report Editor to remove the Volume Capacity (MB) column and replace it with Volume Capacity (GB) column to display the value in Gigabytes. You could even choose to display the Volume Capacity in each of the Units. To make this change, open the Scheduled Report Editor and select the Scheduled Report that you are interested in changing. Then select the table with the space column(s) that you want to change. Click on the Column tab. You can now remove any space columns from the target list that have undesired unit selections, and add the space columns with the desired unit selections.

Scheduled Reports do not retain my changes to widths of my columns. Is this a known issue?
Scheduled reports do not support control over the column widths. If your report has records with long data values, try using the HTML format, or publish the report manually which will retain column width selections.

When I try to cancel a scheduled report that is being published or previewed from the Scheduled Report Editor it appears to freeze up but will eventually complete. Is this a known issue?
Yes, this issue might occur if one of the report items for the scheduled report needs to be processed against a large number of records. The Cancel function waits for the currently executing query to complete, which could take a couple of minutes if the query needs to process through a large number of records. We are currently evaluating methods for speeding the processing of the Cancel function.

What happens if the scheduled report service is unable to connect to one or more of the systems specified in a Scheduled Report?
A report will still be generated to the report path specified for the scheduled report, even if all of the report items fail to be generated. There will be an error message in the report that indicates some of the Report Items could not be generated. The message will indicate which system was unable to return report items, along with some of the possible causes. If you get this type of message in your reports, check to make sure the Systems associated with the scheduled report are reachable and that valid user credentials are specified in the System configuration dialog for connecting to the system. You can review the systems associated with the report items through the Scheduled Report Editor. Just select the scheduled report that generated the error message and click on the Report Properties tab. The System associated with each report item (except Text Blocks) will be displayed in the System column.


top

Agent

How do I tell which port the agent is running on?
Go to the TSFPRMxx member in the PARMLIB dataset and look for the following parameter: LISTENPORT(nnnn)



top

TSF Utilities Functionality

How do I find inefficient GDG bases?
Go to Utilities, option U.2 Catalog. There are several additional queries other than the ones listed below that have been saved and can be retrieved by selecting from the table listing upon entering GETQ on the command line once in the Catalog filter panel.

Empty GDG Base Filter: Display => D, GDG Count => 0, will show all empty GDG Bases.

GDG Bases defined with NOSCRATCH: Display=> D, GDG Base Only: Scratch=> N

How do I use GDG's with the compare utility?
On the TSFSET (UCBSCAN) panel, set the Use GDGs parameter to YES. Upon doing this you may enter GDS database names in the Compare Utility qualified with (0), (-1), etc.

top

DFSMShsm

How do I identify datasets that have failed migration due to ML1 space problems or for any other reason?
Within DFSMShsm Zoom, there is a column labeled E (Errors). This identifies the errors for any given day or month. By entering an "E" next to any day listed, a summary will be displayed listing all HSM errors. By entering an E once again next to any Error category, a listing of datasets will appear for every error occurred.

Alternatively, DFSMShsm Detail has a filter field called Error Return Code and when you enter M* the panel will list all migration errors that occurred during the time stamp period listed in the LOG: date field.

How can I identify why datasets are not migrating?
Within Total Recall "Zoom", there is a column labeled E (Errors). This identifies the errors for any given day or month. By entering an "E" next to any day listed, a summary will be displayed listing all HSM errors. By entering an E once again next to any Error category, a listing of datasets will appear for every error occurred.

Alternatively, Total Recall "Detail", has a filter field called "Error Return Code" where when entering M* will list all migration errors that occurred during the time stamp period listed in the LOG: date field.

How can I reduce the size of the TSF database used by DFSMShsm Zoom?
There are a number of things that can be done but keep in mind this includes either purging records after a shorter retention period or stopping the collection of certain records. Each of these methods results in less data being available for review within the database. See the Purge command in Appendix D, TSF Console Commands of the TSF Mainframe User Guide for modifying the retention of the various records.

Note: No space is reclaimed in the database after purging records until a REORG has been done.

Another method of reducing the size of the database is to prevent recording of certain record types. See SMF Scan Settings Panel in Chapter 5 of the TSF Installation Guide for a list of the various record types that are collected.

How can I improve the maintenance process for the TSF database so that the database is more efficient?
There are a number of things that can be done but keep in mind this includes either purging records after a shorter retention period or stopping the collection of certain records. Each of these methods results in less data being available for review within the database. See the Purge command in Appendix D, TSF Console Commands of the TSF Mainframe User Guide for modifying the retention of the various records.

Note: No space is reclaimed in the database after purging records until a REORG has been done.

Another method of reducing the size of the database is to prevent recording of certain record types. See SMF Scan Settings Panel in Chapter 5 of the TSF Installation Guide to understand the various record types that are collected.

Why do I get "No Records Found" when going into DFSMShsm Zoom?
There may be a couple of reasons why:

  1. Are you looking at the same database that TSFRECRD writes? During installation, when you execute TSFSET (Installation Datasets) panel, all variables are stored in the TSFPRMxx members and should be modified via the setting panels only.
  2. Has TSFRECRD been started so it can begin writing records? Ensure that TSFSPACE and TSFRECRD are running.
  3. Does your DFSMShsm generate SMF records?


top

Automation

How do I set interval (collection) times with Automation?
This can be accomplished by modifying the Collection statements located in member TSFCOLnn of the TSF PARMLIB dataset. You can change the values that are specified in the INTERVAL and TIME parameters. See Chapter 7, "Collection Statements" in the TSF Installation Guide.

How do I change collection rules for a specific day of the week with Automation?
This can be accomplished by changing the day of the week position (DOWPOS keyword) for an IF statement created in the Automation Wizard. This keyword allows the user to specify specific rules to be executed on a particular day of the week or day of the year, i.e., holidays. See Chapter 9, "Automation" in the TSF Mainframe User Guide for instructions on using this keyword.

top

Tape

How do I use existing RMM extract files?
Edit the RMMVOL member in the CNTL dataset so that the RPTEXT parameter reflects NO, rather than YES. Additionally, change the REPTEXT DD in the TFBLDRMM JCL in the CNTL dataset so that it points to the desired RMM extract dataset.

How do I know which Tape database build job to run?
Depending on the tape management system you currently use, there is a field called Tape Subsystem on the TSFSET (TAPESCAN) installation settings panel. This field should specify CA-1, RMM, TLMS, or None (to indicate that none of our supported tape management systems is in use at your installation). The job to run would also depend on the tape system in use, TSFCA1CT, TSFRMMCT, or TSFTLMCT.

What is the basis for the calculation of the tape capacities when displaying percent used in Tape?
In the PARMLIB dataset there is a member called TAPESIZE, which allows the user to specify the tape capacities in megabytes for the respective media types.

top

www.21stCenturySoftware.com ©2010 Estorian, Inc. All Rights Reserved.Legal|Privacy Policy